数据业务交互相关指令

指令名称	功能描述
AT+QIOTSEND	发送透传数据至平台
AT+QIOTRD	读取平台下发的透传数据
AT+QIOTMODELTD	发送物模型数据至平台
AT+QIOTMODELRD	读取平台下发的物模型数据
AT+QIOTINFO	请求QuecThing上报设备信息

AT+QIOTSEND (发送透传数据)

说明：该命令用于发送透传数据至平台。
最大响应时间 ：300 毫秒。
特性说明：该命令立即生效。

测试命令

发送：
c
```
AT+QIOTSEND=?
```

响应：

响应支持的发送模式与数据长度范围

+QIOTSEND: (支持的<mode>范围),(支持的<length>范围),<data>

OK

设置命令

发送：
c
```
AT+QIOTSEND=<mode>,<length>[,<data>]
```
响应：
若指定可选参数且连接已经建立
- 若已配置上行消息需应答PkgID
  c
```
+QIOTSEND: <txid>

OK
```
- 否则
  c
```
OK
```
  若省略可选参数且连接已经建立
c
```
>
```
响应>后，输入长度等于<length>的数据
- 若已配置上行消息需应答PkgID
  c
```
+QIOTSEND: <txid>

OK
```
- 否则
  c
```
OK
```
若出现任何错误
c
```
ERROR
```

参数：
- <mode> 整型。发送模式。
  - 0：发送NON数据，所携带的RAI辅助释放标记设置为0。
  - 1：发送NON数据，所携带的RAI辅助释放标记设置为1。
  - 2：发送NON数据，所携带的RAI辅助释放标记设置为2。
  - 100：发送CON数据，所携带的RAI辅助释放标记设置为0。
  - 101：发送CON数据，所携带的RAI辅助释放标记设置为1。
  - 102：发送CON数据，所携带的RAI辅助释放标记设置为2。
    发送模式解析：
    NON模式：表示设备发送数据时不需要服务器ACK。
    CON模式：表示设备发送数据并收到服务器ACK后，会通过URC通知到应用层。
    RAI辅助释放标记解析：
    0：无标记。
    1：该包上行数据后不期望有进一步的上行或下行数据，核心网可立即释放。
    2：指示该数据包上行数据后期望有对应回复的单个下行数据包，核心网在下发后立即释放。
- <length>：整型。待发送数据长度。单位：字节。
  - 若设置命令中指定<data>，长度范围以测试命令实际返回值为准
  - 若设置命令中不指定<data>，长度范围以模块性能为准
- <data>： 发送数据。
  - 若设置命令中指定<data>，待发送数据仅可为字符串类型
  - 若设置命令中不指定<data>，待发送数据为任意字节流类型，以模块性能为准
- <txid>： 整型。
  - Qos=0时txid为0
  - Qos>0时，返回发送消息txid(1~65535)
备注：
- 2.1.2及以上版本支持。 <mode>参数为CON数据会有事件回调。参数<txid>不支持。

示例1 (发送透传数据)
提示：业务数据交互期间请保证设备正常在线。

发送“ABCabc123456”透传数据上行到平台，响应 > 后发送 “ABCabc123456”。

[TX]AT+QIOTSEND=1,12

[RX]> 
[TX]ABCabc123456
[RX]OK

[RX]+QIOTEVT: 4,10200

AT+QIOTRD (读取透传数据)

说明：该命令用于读取平台下发的透传数据。
最大响应时间 ：300 毫秒。
特性说明：该命令立即生效。

测试命令

发送：
c
```
AT+QIOTRD=?
```

响应：

响应读取的数据长度

+QIOTRD: (支持的<req_length>范围)

OK

查询命令

发送：
c
```
AT+QIOTRD?
```
响应：
响应剩余数据包个数
c
```
+QIOTRD: <remain_pieces>

OK
```

设置命令

发送：
c
```
AT+QIOTRD=<req_length>
```

响应：

读取透传数据成功

+QIOTRD: <cur_len>,<remain_len>,<remain_pieces>
<data>

否则

ERROR

参数：
- <req_length>：整型。读取的数据长度。长度范围以测试命令实际返回值为准。
- <cur_len>：整型。实际读取的数据长度。
- <data>：字节流类型。读取的数据。
- <remain_len>：整型。当前数据包剩余未读的数据长度。单位：字节。
- <remain_pieces>：整型。剩余数据包个数。
备注：
- 2.1.2及以上版本支持

示例

提示：业务数据交互期间请保证设备正常在线。

示例1 (缓存模式读取下行数据)
i. 平台下发“123456”的透传数据。
ii. 模组打印回调事件 {+QIOTEVT: 5,10200}。
iii. 发送 AT+QIOTRD? 查询未读数据包个数。
iiii. 发送 AT+QIOTRD=1024 查询读取的数据。

[RX]+QIOTEVT: 5,10200
[TX]AT+QIOTRD?

[RX]+QIOTRD: 1

[RX]OK
[TX]AT+QIOTRD=1024

[RX]+QIOTRD: 6,0,0
[RX]123456
[RX]OK

示例2 (非缓存模式读取下行数据) 在非缓存下， IoT 平台下行透传数据模组会将数据主动打印到串口。

[RX]+QIOTEVT: 5,10200,6
123456

AT+QIOTMODELTD (发送物模型数据)

说明：该命令用于发送物模型数据至平台。设置命令中若指定<PkgID>，则发送数据为应答平台数据请求；若省略<PkgID>，则发送数据至平台;
- 上报成功且消息类型为CON数据时，MCU接收事件+QIOTEVT: 4,10210表示物模型数据发送成功。
最大响应时间 ：300 毫秒。
特性说明：该命令立即生效。

测试命令

发送：
c
```
AT+QIOTMODELTD=?
```

响应：

响应支持的参数范围

+QIOTMODELTD: (支持的<mode>范围),<length>,(支持的 <PkgID>范围)

OK

设置命令

发送：

AT+QIOTMODELTD=<mode>,<length>[,<PkgID>]

响应：
c
```
>
响应>后，输入长度等于<length>的字节流数据。
```
若配置上行消息需应答PkgID，则为应答平台查询的消息
c
```
OK
```
若配置上行消息无需应答PkgID，则为主动发送上行消息
- 其中当配置AT+QIOTCFG="txid_mode",1 返回内容为
  c
```
+QIOTMODELTD: <txid>

OK
```
- 否则返回内容为
  c
```
OK
```
若出现任何错误
c
```
ERROR
```

参数：
- <mode> 整型。发送模式
  - 0：发送NON数据，所携带的RAI辅助释放标记设置为0。
  - 1：发送NON数据，所携带的RAI辅助释放标记设置为1。
  - 2：发送NON数据，所携带的RAI辅助释放标记设置为2。
  - 100：发送CON数据，所携带的RAI辅助释放标记设置为0。
  - 101：发送CON数据，所携带的RAI辅助释放标记设置为1。
  - 102：发送CON数据，所携带的RAI辅助释放标记设置为2。
    发送模式解析：
    NON模式：表示设备发送数据时不需要服务器ACK。
    CON模式：表示设备发送数据并收到服务器ACK后，会通过URC通知到应用层。
    RAI辅助释放标记解析：
    0：无标记。
    1：该包上行数据后不期望有进一步的上行或下行数据，核心网可立即释放。
    2：指示该数据包上行数据后期望有对应回复的单个下行数据包，核心网在下发后立即释放。
- <length>：整型。待发送数据长度。长度范围以具体模块性能为准。
- <PkgID>： 整型。请求包ID。范围：1~65534。仅当设备需响应平台数据请求时需指定该参数。
- <txid>： 整型。
  - Qos = 0时txid为0
  - Qos > 0时，返回发送消息txid(1~65535)
备注：
- 2.1.2及以上版本支持。参数<txid>不支持。

示例

前提：在开发者中心根据实际项目需求添加物模型功能，业务数据交互期间请保证设备正常在线。

示例1 (发送物模型属性数据)

物模型 ID：1；类型：布尔值；内容：true ；
物模型 ID：2；类型：整型；内容：100；
物模型 ID：3；类型：浮点型；内容：28.56 ；
物模型 ID：4；类型：枚举；内容：1 ；
物模型 ID：5；类型：文本型；内容：Hello World ；
物模型 ID：6；类型：日期；内容：1658030723000 ；
物模型 ID：7；类型：结构体；结构体内容：{"1":true,"2":100} ；

[TX]AT+QIOTMODELTD=1,93

[RX]> 
[TX]{"1":true,"2":100,"3":28.56,"4":1,"5":"Hello World","6":1658030723000,"7":{"1":true,"2":100}}
[RX]OK

[RX]+QIOTEVT: 4,10210

示例2 (发送物模型事件数据)

物模型事件 ID：2；{ 输出参数 ID：1；类型：浮点型；内容：25.86 }；

[TX]AT+QIOTMODELTD=1,17

[RX]> 
[TX]{"2":{"1":25.86}}
[RX]OK

[RX]+QIOTEVT: 4,10210

示例3 (响应平台物模型请求包)

i. 在开发者中心 点击读取物模型按钮。 ii. 模组打印回调事件{+QIOTEVT: 5,10211,7,1}。 iii. 响应请求包 ID为 7 的物模型数据。

[TX]AT+QIOTMODELTD=1,11,7

[RX]> 
[TX]{"1":25.14}
[RX]OK

[RX]+QIOTEVT: 4,10210

示例4 (发送物模型属性数组结构体数据)

物模型 ID：8；类型：数组；最大元素个数：3；
- 元素类型：结构体
  - 物模型 ID：1；类型：布尔值；
  - 物模型 ID：2；类型：整型；
  - 物模型 ID：3；类型：枚举；
  - 物模型 ID：4；类型：文本型；

[TX]AT+QIOTMODELTD=1,120

[RX]> 
[TX]{"8":[{"1":true,"2":10,"3":1,"4":"ABC123"},{"1":false,"2":10,"3":1,"4":"ABC123"},{"1":false,"2":10,"3":1,"4":"ABC123"}]}
[RX]OK

[RX]+QIOTEVT: 4,10210

AT+QIOTMODELRD (读取物模型数据)

说明：该命令用于读取平台下发的物模型数据。
最大响应时间 ：300 毫秒。
特性说明：该命令立即生效。

测试命令

发送：
c
```
AT+QIOTMODELRD=?
```

响应：

响应支持的读取的数据范围

+QIOTMODELRD: (支持的<req_length>范围)

OK

查询命令

发送：
c
```
AT+QIOTMODELRD?
```
响应：
响应剩余数据包个数
c
```
+QIOTMODELRD: <remain_pieces>

OK
```

设置命令

发送：
c
```
AT+QIOTMODELRD=<req_length>
```

响应：

若指定可选参数且连接已经建立

+QIOTMODELRD: <cur_len>,<remain_len>,<remain_pieces>
<data>	
	
OK

若出现任何错误

ERROR

参数：
- <req_length>：整型。读取的数据长度。长度范围以测试命令实际返回值为准。
- <cur_len>：整型。实际读取的数据长度。
- <data>：字节流类型。读取的物模型数据。
- <remain_len>：整型。当前数据包剩余未读的数据长度。单位：字节。
- <remain_pieces>：整型。剩余数据包个数。
备注：
- 2.1.2及以上版本支持

示例

前提：在开发者中心根据实际项目需求添加物模型，业务数据交互期间请保证设备正常在线。

示例1 (非缓存模式下读取物模型数据)

物模型 ID：1；类型：布尔值；内容：true ；
物模型 ID：2；类型：整型；内容：100；
物模型 ID：3；类型：浮点型；内容：28.56 ；
物模型 ID：4；类型：枚举；内容：1 ；
物模型 ID：5；类型：文本型；内容：Hello World ；
物模型 ID：6；类型：日期；内容：1658030723000 ；
物模型 ID：7；类型：结构体；结构体内容：{"1":true,"2":100} ；

[RX]+QIOTEVT: 5,10210,93
[RX]{"1":true,"2":100,"3":28.56,"4":1,"5":"Hello World","6":1658030723000,"7":{"1":true,"2":100}}

示例2 (缓存模式下读取物模型数据)

物模型 ID：1；类型：布尔值；内容：true ；
物模型 ID：2；类型：整型；内容：100；
物模型 ID：3；类型：浮点型；内容：28.56 ；
物模型 ID：4；类型：枚举；内容：1 ；
物模型 ID：5；类型：文本型；内容：Hello World ；
物模型 ID：6；类型：日期；内容：1658030723000 ；
物模型 ID：7；类型：结构体；结构体内容：{"1":true,"2":100} ；

[RX]+QIOTEVT: 5,10210
[TX]AT+QIOTMODELRD=1024 
[RX]+QIOTMODELRD: 93,0,0
[RX]{"1":true,"2":100,"3":28.56,"4":1,"5":"Hello World","6":1658030723000,"7":{"1":true,"2":100}}

[RX]OK

AT+QIOTINFO (请求QuecThing上报设备信息)

说明：该命令用于请求QuecThing上报设备信息。
最大响应时间 ：300 毫秒。
特性说明：该命令立即生效。

测试命令

发送：
c
```
AT+QIOTINFO=?
```
响应：
c
```
+QIOTINFO: "up"

OK
```

查询命令

发送：
c
```
AT+QIOTINFO?
```

响应：

响应上报信息的关键字及数据

+QIOTINFO: <item1>,<value1>
[+QIOTINFO: <item2>,<value2>
[...]]
OK

若出现任何错误

ERROR

设置命令

发送：
c
```
AT+QIOTINFO="up"
```
响应：
上报设备信息成功
c
```
OK
```
或者
c
```
ERROR
```

参数：
- <itemN>：字符串类型。上报信息的关键字。
- <valueN>：字符串类型。数据。
备注：
- 2.1.2及以上版本支持

示例

示例1 (上报设备信息)

[TX]AT+QIOTINFO="up"

[RX]OK

上报设备包含信息，如下：

设备状态

字段	描述
type	模组型号
version	模组版本
mcu_version	MCU版本
cell_id	基站ID
icc_id	SIM卡号
mcc	移动国家代码
mnc	移动网络代码
lac	位置区代码
phone_num	phone号
sim_num	SIM号
sdk_ver	SDK版本号

设备信息

字段	描述
battery	电量（百分比）
voltage	电压（伏特）
signal_strength	信号强度（RSSI）
memory_free	剩余空间（字节）
rsrp	参考信号接收功率（RSRP）
rsrq	LTE参考信号接收质量（RSRQ）
snr	信号与干扰加噪声比（SNR）

MCU仿真工具快速接入

示例概览

IoT AT指令

快速接入指引

示例概览

QTHSDK API

快速接入指引

示例概览

QTHSDK API

快速接入指引

示例概览

QTHSDK API

MCU仿真工具快速接入

示例概览

IoT AT指令

OTA概述

OTA升级流程

用户账号

设备添加

设备管理

家庭管理

用户账号

设备添加

设备管理

家庭管理

OpenAPI列表

OpenAPI列表

数据业务交互 相关指令 ​

相关AT指令列表 ​

相关AT指令详情 ​

AT+QIOTSEND (发送透传数据) ​

测试命令 ​

设置命令 ​

AT+QIOTRD (读取透传数据) ​

测试命令 ​

查询命令 ​

设置命令 ​

示例 ​

AT+QIOTMODELTD (发送物模型数据) ​

测试命令 ​

设置命令 ​

示例 ​

AT+QIOTMODELRD (读取物模型数据) ​

测试命令 ​

查询命令 ​

设置命令 ​

示例 ​

AT+QIOTINFO (请求QuecThing上报设备信息) ​

测试命令 ​

查询命令 ​

设置命令 ​

示例 ​

数据业务交互相关指令

相关AT指令列表

相关AT指令详情

AT+QIOTSEND (发送透传数据)

测试命令

设置命令

AT+QIOTRD (读取透传数据)

测试命令

查询命令

设置命令

示例

AT+QIOTMODELTD (发送物模型数据)

测试命令

设置命令

示例

AT+QIOTMODELRD (读取物模型数据)

测试命令

查询命令

设置命令

示例

AT+QIOTINFO (请求QuecThing上报设备信息)

测试命令

查询命令

设置命令

示例