数据交互
设备数据上报
终端发送数据到天翼物联网平台(AIoT)(平台进行数据解析)
Command | 返回结果 |
AT+ZCTAPP=22, <Qos>,<UpDataSN>,<PayloadType>,<DataSetID>,<Payload>[,DataCollectResult] | <CR><LF>+ZCTAPP:<MsgId>,<Result><CR><LF> <CR><LF>OK<CR><LF> or <CR><LF>ERROR:<err><CR><LF> |
<Qos>为 1 时,模组后续会发送报文传输处理结果通知:
<CR><LF>+ZCTM2M:1,<MsgID>,<result><CR><LF>
(1) AT指令参数
参数 | 描述 |
Qos | uint(1),必选,本报文传输模式 0(尽力传送) 1(至少一次) |
UpDataSN | uint(4),必选,数据上报序列号/流水号 |
PayloadType | uint(1),必选,上报数据的数据集类型 0 普通的紧凑二进制模式 1 带采集结果说明的紧凑二进制格式 2 普通 JSON 模式 |
DatasetID | uint(2),必选,上报数据的数据集标识 |
Payload | binary,必选,变长,上报数据内容 |
DataCollectResult | binary,上报数据的采集结果说明 (仅当PayloadType参数为1时,需要提供该参数) |
(2) AT指令返回信息
返回参数说明:
返回参数 | 说明 |
MsgId | uint(4),指令序列号 (<Qos>为 1 时,需要通过 MsgID 关联后续的+ZCTM2M 通知) (<Qos>为 0 时,此 MsgID 可被忽略)
|
Result | uint(1),固定为 0(数据进入发送队列)
|
(3)AT指令错误码
AT 指令执行失败返回错误码(<err>):
错误码 | 说明 |
800 | 内存申请失败 |
802 | AT指令名称错误 |
803 | 操作类型错误 |
804 | 未初始化 |
805 | 未登录,不能登出也不能收发数据 |
807 | 参数个数错误 |
808 | PayloadType取值错误 |
809 | 参数值不在指定范围内(含String,int) |
810 | 参数类型错误 |
811 | 输入参数为空 |
812 | 不是hex字符串 |
813 | WIFI未连接 |
816 | 忙碌中不允许并行业务处理 |
211 | 内存不足 |
301 | 发送长度超限 |
997 | 队列数目越界(发送队列已满) |
560 | 数据上报,非法Payload值(应不为空(NULL或len=0)) |
561 | 数据上报,无效数据集类型 |
562 | 数据上报,无效QoS |
563 | 数据上报失败,非法DataCollectResult值(应不为空(NULL或len=0)) |
(4)AT指令返回样例
AT+ZCTAPP=22,0,12345678,0,1,1234
+ZCTAPP:2345,0
OK
AT+ZCTAPP=22,0,12345678,1,1,111111,7f
+ZCTAPP:2345,0
OK
QOS=1 时,后续模组会向终端发送报文传输处理结果通知
AT+ZCTAPP=22,1,12345678,1,1,111111,7f
+ZCTAPP:4,0
OK
+ZCTM2M:1,4,3
数据推送到天翼物联网平台(AIoT)后,平台会将数据进行统一格式,用户可以在门户的“数据查看“标签页查询某一设备的数据上报结果。(注:在数据查看标签页查询数据上报结果,需要在检索框填写设备ID,并选择需查询具体的时间范围):
5.4.5.2.2 设备事件上报
终端发送事件信息到天翼物联网平台(AIoT)
Command | 返回结果 |
AT+ZCTAPP=24, <Qos>,<EventSN>,<EventID>,<EventTime>,<EventType> [, <PayloadType>,<Payload>] | <CR><LF>+ZCTAPP:<MsgId>,<Result><CR><LF> <CR><LF>OK<CR><LF> or <CR><LF>ERROR:<err><CR><LF> |
<Qos>为 1 时,模组后续会发送报文传输处理结果通知:
<CR><LF>+ZCTM2M:1,MsgID,result<CR><LF>
(1) AT指令参数
参数 | 描述 |
Qos | uint(1),必选,本报文传输模式 0(尽力传送) 1(至少一次) |
EventSN | uint(4),必选,事件上报序列号/流水号 |
EventID | uint(2),必选,事件标识(区分不同的事件类型) |
EventTime | uint(8) 必选 事件发生时间的时间戳 (表示从 1970 年 1 月 1 日 0 点之后到”当前”经过的时间长度(以秒为单位) |
EventType | uint(1) 必选 事件类型 0 普通事件 1 告警事件(普通级) 2 告警事件(重大级) 3 告警事件(严重级) |
可以提供以下参数,以进一步提供事件附加信息(若提供,须一起提供):
参数 | 描述 |
PayloadType | uint(1),事件附加信息的数据集类型 0 普通的紧凑二进制模式 2 普通 JSON 模式 |
Payload | binary,变长,事件附加信息 |
(2) AT指令返回信息
返回参数说明:
返回参数 | 说明 |
MsgId | uint(4),指令序列号 (<Qos>为 1 时,需要通过 MsgID 关联后续的+ZCTM2M 通知) (<Qos>为 0 时,此 MsgID 可被忽略) |
Result | uint(1) 固定为 0(数据进入发送队列) |
(3)AT指令错误码
AT 指令执行失败返回错误码(<err>):
错误码 | 说明 |
800 | 内存申请失败 |
802 | AT指令名称错误 |
803 | 操作类型错误 |
804 | 未初始化 |
805 | 未登录,不能登出也不能收发数据 |
807 | 参数个数错误 |
808 | PayloadType取值错误 |
809 | 参数值不在指定范围内(含String,int) |
810 | 参数类型错误 |
811 | 输入参数为空 |
812 | 不是hex字符串 |
813 | WIFI未连接 |
816 | 忙碌中不允许并行业务处理 |
211 | 内存不足 |
301 | 发送长度超限CTIOT_MQTT_BUFFER_OVERFLOW |
997 | 队列数目越界(发送队列已满) |
580 | 事件上报,eventType不合法 |
581 | 事件上报,payloadType不合法 |
582 | 事件上报,非法Payload值(若不为NULL,len>0) |
583 | 事件上报,无效QoS |
(4)AT指令返回样例
AT+ZCTAPP=24,0,1,1,20181205,0,0,41F00000
+ZCTAPP:8,0
OK
事件数据推送到天翼物联网平台(AIoT)后,用户可以在门户的“事件上报“标签页查询某一设备的事件上报结果: