合作伙伴工作台
注册

数据交互

设备数据上报

终端发送数据到天翼物联网平台(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)后,用户可以在门户的“事件上报“标签页查询某一设备的事件上报结果:


这篇文档是否帮助您解决了问题?
如果您愿意进一步帮助我们改进文档 ,请留下您的联系方式。