产品配置 相关指令
相关AT指令列表
| 指令名称 | 功能描述 | 备注 |
|---|---|---|
| AT+QIOTCFG | 配置可选参数 | 可选参数 : ● 查询/配置产品信息 ● 查询/配置服务器信息 ● 查询/配置设备生命周期 ● 查询/配置下行数据缓存模式 ● 查询/配置 PDP 上下文 ID ● 查询/配置设备与平台之间的连接加密模式 ● 查询/配置物模型数据结构格式 ● 查询/设置自定义设备标识和设备密钥 ● 查询/配置上行消息发送后是否返回上行消息的<txID> |
| AT+QIOTREG | 配置平台连接模式 | |
| AT+QIOTSTATE | 查询当前设备与平台之间的连接状态 | |
| AT+QIOTMCUVER | 配置 MCU 版本号 |
相关AT指令详情
AT+QIOTCFG (配置可选参数)
- 说明：该命令用于配置可选参数。
- 最大响应时间 ：300 毫秒。
- 特性说明：该命令立即生效；参数配置自动保存。
测试命令
发送：
cAT+QIOTCFG=?响应：
c+QIOTCFG: "productinfo",<pk>,<ps> +QIOTCFG: "server",(支持的<server_type>列表),<server_URL> +QIOTCFG: "lifetime",(支持的<lifetime>范围) +QIOTCFG: "buffer",(支持的<buffer_mode>列表) +QIOTCFG: "act",(支持的<contextID>范围) +QIOTCFG: "session_mode",(支持的<session_mode>列表) +QIOTCFG: "tsl",(支持的<tsl_mode>列表) +QIOTCFG: "dk_ds",<dk>[,<ds>] +QIOTCFG: "txid_mode",(支持的<txid_mode>列表) OK调用示例(查询可配置的信息及范围)
设备上电后，若未配置信息，执行 AT+QIOTCFG=? 查询可配置的信息及范围。
c[TX]AT+QIOTCFG=? [RX]+QIOTCFG: "productinfo",<pk>,<ps> +QIOTCFG: "server",1,<server_URL> +QIOTCFG: "lifetime",(1-65535) +QIOTCFG: "buffer",(0,1) +QIOTCFG: "act",(1-15) +QIOTCFG: "session_mode",(0,1) +QIOTCFG: "tsl",(0,1) +QIOTCFG: "dk_ds",<dk>,<ds> +QIOTCFG: "txid_mode",(0,1) [RX] OK
设置命令
查询/配置产品信息
发送：
cAT+QIOTCFG="productinfo"[,\<pk\>,\<ps\>]响应：
若省略可选参数，则查询当前产品信息
c+QIOTCFG: "productinfo",<pk>,<ps>,<ver> OK若指定可选参数，则配置产品信息
cOK若出现任何错误
cERROR
参数：
<pk>：字符串类型。创建产品生成的 ProductKey。<ps>：字符串类型。创建产品生成的 ProductSecret。<ver>：字符串类型。设备认证协议版本号。
备注：
- 2.3.3及以上版本支持
调用示例 (初始化配置产品信息)
cAT+QIOTCFG="productinfo","p****n","RMW**********Dlt" OK
查询/配置服务器信息
发送：
cAT+QIOTCFG="server"[,<server_type>,<server_URL>]响应：
若省略可选参数，则查询当前服务器信息
c+QIOTCFG:"server",<server_type>,<server_URL> OK若指定可选参数，则配置服务器信息
cOK若出现任何错误
cERROR
参数：
<server_type>： 整型。支持的协议类型。1: MQTT 协议
<server_URL>：字符串类型。服务器地址（平台域名和端口）。 默认值："mqtt://iot-south.quectel.com:1883"。地区 域名 中国地区非加密 mqtt://iot-south.quectelcn.com:1883 中国地区加密 mqtts://iot-south.quectelcn.com:8883 欧洲地区非加密 mqtt://iot-south.acceleronix.io:1883 欧洲地区加密 mqtts://iot-south.acceleronix.io:8883
备注：
- 2.3.3及以上版本支持
调用示例 (配置服务器信息)
cAT+QIOTCFG="server",1,"mqtt://iot-south.quectelcn.com:1883" OK
查询/配置设备生命周期
发送：
cAT+QIOTCFG="lifetime"[,<lifetime>]响应：
若省略可选参数，则查询当前设备生命周期
c+QIOTCFG: "lifetime",<lifetime> OK若指定可选参数，则配置设备生命周期
cOK若出现任何错误
cERROR
参数：
<lifetime>：整型。设备生命周期。单位：秒(范围：1~65535；默认值：120)
备注：
- 2.3.3及以上版本支持
调用示例 (配置设备生命周期)
cAT+QIOTCFG="lifetime",120 OK
查询/配置下行数据缓存模式
- 发送：
cAT+QIOTCFG="buffer"[,<buffer_mode>]响应：
若省略可选参数，则查询当前下行数据缓存模式
c+QIOTCFG: "buffer",<buffer_mode> OK若指定可选参数，则配置下行数据缓存模式
cOK若出现任何错误
cERROR
- 参数：
<buffer_mode>：整型。关闭或开启下行数据缓存模式。0：关闭缓存模式1：开启缓存模式
- 备注：
- 2.3.3及以上版本支持
调用示例 (打开下行数据缓存模式)
cAT+QIOTCFG="buffer",1 OK
查询/配置 PDP 上下文 ID
发送：
cAT+QIOTCFG="act"[,<contextID>]响应：
若省略可选参数，则查询当前使用的 PDP 上下文 ID
c+QIOTCFG: "act",<contextID> OK若指定可选参数，则配置设备连接平台使用的 PDP 上下文 ID
cOK若出现任何错误
cERROR
- 参数：
<contextID>整型。场景 ID。范围：1~15。实际范围以具体模块为准。
- 备注：
- 2.3.3及以上版本支持
调用示例 (配置设备连接平台使用的PDP 上下文 ID)
cAT+QIOTCFG="act",1 OK
查询/配置设备与平台之间的连接加密模式
发送：
cAT+QIOTCFG="session_mode"[,<session_mode>]响应：
若省略可选参数，则查询当前设备与平台之间的连接加密模式
c+QIOTCFG: "session_mode",<session_mode>[,<session_mode>] OK若指定可选参数，则配置设备与平台之间的连接加密模式
cOK若出现任何错误：
cERROR
- 参数：
<session_mode>整型。关闭或开启设备与平台之间的连接加密模式。0： 关闭加密模式1： 开启加密模式
- 备注：
- 2.7.2及以上版本支持
调用示例 (开启设备与平台之间的连接加密模式)
cAT+QIOTCFG="session_mode",1 OK
查询/配置物模型数据结构格式
发送：
cAT+QIOTCFG="tsl"[,<tsl_mode>]响应：
若省略可选参数，则查询当前物模型数据结构格式
c+QIOTCFG: "tsl",<tsl_mode> OK若指定可选参数，则配置物模型数据结构格式
cOK若出现任何错误：
cERROR
- 参数：
<tsl_mode>整型。物模型数据格式。0：TTLV 格式1：JSON 格式
- 备注：
- 2.8.0及以上版本支持
调用示例 (配置物模型JSON数据格式)
cAT+QIOTCFG="tsl",1 OK
查询/设置自定义设备标识和设备密钥
发送：
cAT+QIOTCFG="dk_ds",[<dk>[,<ds>]]响应：
若省略可选参数，则查询当前设备标识和设备密钥（仅支持查询通过该命令自定义的设备标识）
c+QIOTCFG:"dk_ds",<dk>,<ds> OK若仅指定<dk>且为空字符串，则删除自定义的<dk>与<ds>，并使用默认配置
cOK若仅指定<dk>且不为空，则自定义设备标识，设备将开始认证流程
cOK若指定可选参数且不为空，则自定义设备标识和设备密钥
cOK若指定可选参数，且<dk>和<ds>为空字符串，则清除自定义的设备标识和设备密钥
cOK若出现任何错误：
cERROR
- 参数：
<dk>字符串类型。用户自定义的设备的唯一标识。蜂窝移动模块默认值为 IMEI 号。<ds>字符串类型。设备认证后获取的密钥。
- 备注：
- 2.8.0及以上版本支持
调用示例 (配置自定义设备标识)
cAT+QIOTCFG="dk_ds","12345678" OK
查询/配置上行消息发送后是否返回上行消息的<txID>
发送：
cAT+QIOTCFG="txid_mode"[,<txid_mode>]响应：
若省略可选参数，则查询当前配置
c+QIOTCFG: "txid_mode",<txid_mode> OK若指定可选参数，则配置上行消息发送后是否返回上行消息的<txID>
cOK若出现任何错误：
cERROR
- 参数：
<txid_mode>整型。上行消息发送后是否返回上行消息的<txID>。0: 不返回1: 返回<txID>整型。上行消息 ID。1: QoS = 0 时，值始终为 02: QoS = 1/2 时，范围：1~65535
- 备注：
- 2.10.0及以上版本支持
- 调用示例 (配置上行消息)c
[TX]AT+QIOTCFG="txid_mode",1 [RX]OK
AT+QIOTREG (配置平台连接模式)
- 说明：该命令用于配置平台连接模式。
- 最大响应时间 ：300 毫秒。
- 特性说明：该命令立即生效；参数配置自动保存。
测试命令
发送：
cAT+QIOTREG=?响应：
返回支持的连接模式范围
c+QIOTREG: (支持的<reg_mode>范围) OK
查询命令
发送：
cAT+QIOTREG?响应：
返回支持的连接模式范围
c+QIOTREG: <reg_mode> OK
设置命令
发送：
cAT+QIOTREG=<reg_mode>响应：
若设置成功
cOK若出现任何错误
cERROR
参数：
<reg_mode>整型。连接模式。0：注销并关闭接入 QuecThing 功能。1：手动启用 QuecThing；如果没有配置 PK/PS/开发者中心 域名端口，则返回 ERROR。2：自动启用 Quecthing；此模式会在模块开机后自动连接 开发者中心 服务器，如果没有配置 PK/PS/开发者中心 域名端口，则返回 ERROR。
备注：
- 2.3.3及以上版本支持
示例
示例1 (查询设备与 IoT 平台的连接模式) 响应 0 ：注销并关闭接入。
AT+QIOTREG?
+QIOTREG: 0
OK示例2 (配置手动启用连接 IoT 平台模式)
AT+QIOTREG=1
OKAT+QIOTSTATE (查询平台连接状态)
- 说明：该命令用于查询当前设备与平台之间的连接状态。
- 最大响应时间 ：300 毫秒。
查询命令
发送：
cAT+QIOTSTATE?响应：
响应平台连接状态
c+QIOTSTATE: <state> OK
参数：
<state>整型。平台连接状态。0： 未初始化。1： 已初始化。2： 正在认证。3： 认证成功。4： 认证失败。5： 正在注册。6： 注册成功，等待订阅。7： 注册失败。8： 已订阅，数据可发送。9： 订阅失败。10： 正在注销。11： 注销成功。12： 注销失败。
备注：
- 2.3.3及以上版本支持
示例
示例1 (查询平台连接状态) 响应 8 ：终端设备已连接上 IoT 平台，可以进行数据业务交互。
AT+QIOTSTATE?
+QIOTSTATE: 8
OKAT+QIOTMCUVER (配置 MCU 版本号)
- 说明：该命令用于配置 MCU 版本号。
- 最大响应时间 ：300 毫秒。
- 特性说明：该命令立即生效；参数配置自动保存。
测试命令
发送：
cAT+QIOTMCUVER=?响应：
响应是否支持该指令
c+QIOTMCUVER: <MCU_number>,<MCU_version> OK
查询命令
发送：
cAT+QIOTMCUVER?响应：
响应已设置的MCU编号及MCU对应的版本
c+QIOTMCUVER: <MCU_number1>,<MCU_version1> [+QIOTMCUVER: <MCU_number2>,<MCU_version2>] […] OK若出现任何错误：
cERROR
设置命令
发送：
cAT+QIOTMCUVER=<MCU_number>[, <MCU_number_version>]响应：
若省略可选参数，则查询当前 MCU 版本
c+QIOTMCUVER: <MCU_number>,<MCU_version> OK若指定可选参数，则配置 MCU 版本
cOK若出现任何错误
cERROR
参数：
- <MCU_numberN>：字符串类型。MCU 编号。
- <MCU_versionN>： 字符串类型。MCU 对应的版本。
备注：
- 2.3.3及以上版本支持
示例
示例1 (查询当前MCU版本号) 响应：MCU编号为 MCU1；对应的版本号为：1.0.0 。
AT+QIOTMCUVER?
+QIOTMCUVER: "MCU1","1.0.0"
OK示例2(配置MCU编号与版本号)
配置当前MCU编号为“MCU1”及版本号为“1.0.1”。
AT+QIOTMCUVER="MCU1","1.0.1"
OK