文档中心

主题

设备与平台交互 相关事件 ​

事件回调格式： ​

单品或网关设备 ​

+QIOTEVT: <event_type>,<event_code> [,<data>]

网关子设备 ​

+QIOTSUBEVT: <subPK>,<subDK>,<event_type>,<event_code>,[,<data>]

事件类别解析： ​

  • <event_type> ：整型。事件标识符。
    • 1： 引导认证操作
    • 2： 接入操作
    • 3： 订阅操作
    • 4： 发送数据操作
    • 5： 接收数据操作
    • 6： 注销操作
    • 7： OTA 操作
    • 8： 平台事件
    • 9: 唤醒事件
    • 10：子设备注销操作
    • 30：数采操作

  • <subPK> ：字符串类型。在开发者中心创建产品时生成的 ProductKey。
  • <subDK> ：字符串类型。子设备唯一标识。
  • <event_code>： 整型。事件返回码。
  • <data>： 事件携带数据内容。

事件返回码<event_type><event_code>： ​

1：引导认证操作 ​

事件标识,事件码描述处理方式
1,10200设备认证成功，子设备：URC中紧跟,<subDS>
1,10300其他错误设备内部错误，请联系移远技术支持进行抓包分析
1,10404平台内部接口调用错误设备内部错误，请联系移远技术支持进行抓包分析
1,10421静态设备不允许认证使用静态设备秘钥配置指令，配置静态设备的设备秘钥
1,10422设备已认证（连接失败）设备DeviceSecret错误，需在开发者中心重置DeviceSecret
1,10423查询产品信息失败（连接失败）设备ProductKey配置错误，检查ProductKey配置
1,10424PAYLOAD 解密失败（连接失败）可能性一：设备ProductKey配置错误，检查ProductSecret配置
可能性二：设备DeviceSecret解密失败，检查模组与平台的DeviceSecret
1,10425签名验证未通过（连接失败）设备DeviceKey非法，DeviceKey长度不符合(4-32位，数字、字母大小写均可)
1,10427散列信息不合法（连接失败）设备内部错误，请联系移远技术支持进行抓包分析
1,10431DK 不合法（连接失败）设备DeviceKey非法，DeviceKey长度不符合(4-32位，数字、字母大小写均可)
1,10433Flag 不合法设备内部错误，请联系移远技术支持进行抓包分析
1,10434ClientID 与password不匹配（password中包涵ClientID 相关信息）设备内部错误，请联系移远技术支持进行抓包分析
1,10440网关与子设备无关联关系
1,10450设备内部错误（连接失败）可能性一：设备暂无网络，请检查设备天线是否有接与注网状态
可能性二：设备内部错误，请联系移远技术支持进行抓包分析
1,10500设备认证失败（系统发生未知异常）设备内部错误，请联系移远技术支持进行抓包分析

2：接入操作 ​

事件标识,事件码描述处理方式
2,10200注册成功
2,10404平台内部接口调用错误设备内部错误，请联系移远技术支持进行抓包分析
2,10430设备密钥不正确（连接失败）设备DeviceSecret设置错误，需重置模组和平台的DeviceSecret
2,10431设备被禁用（连接失败）设备内部错误，请联系移远技术支持进行抓包分析
2,10433Flag 不合法设备内部错误，请联系移远技术支持进行抓包分析
2,10434ClientID 与password不匹配（password中包涵ClientID 相关信息）设备内部错误，请联系移远技术支持进行抓包分析
2,10437设备秘钥错误重新发起连接平台或等待设备自动重连
2,10438平台未查询到设备信息重新发起连接平台或等待设备自动重连
2,10441子设备已连接（连接成功）
2,10450设备内部错误（连接失败）可能性一：设备暂无网络，请检查设备天线是否有接与注网状态
可能性二：设备内部错误，请联系移远技术支持进行抓包分析
2,10471实现方案版本不支持(连接失败)设备内部错误，请联系移远技术支持进行抓包分析
2,10473接入心跳异常（连接超时）设备暂无网络，请检查设备天线是否有接与注网状态
2,10474网络异常（连接超时）设备暂无网络，请检查设备天线是否有接与注网状态
2,10475服务器发生改变服务器或产品信息发生改变，需修改设备产品信息或服务器信息
2,10476连接 AP 异常设备暂无网络，请检查设备天线是否有接与注网状态
2,10477设备被禁用（连接失败）设备DeviceKey非法，检查DeviceKey是否合法
2,10478设备重置失败可能为动态设备秘钥使用静态设备秘钥配置接口导致，请检查设备是否为动态设备
2,10500注册失败（系统发生未知异常）设备内部错误，请联系移远技术支持进行抓包分析

3：订阅操作 ​

事件标识,事件码描述处理方式
3,10200订阅成功
3,10300订阅失败设备内部错误，请联系移远技术支持进行抓包分析

4：发送数据操作 ​

事件标识,事件码描述备注处理方式
4,10200[,<txid>]透传数据发送成功txid_mode配置项开启后返回txid
4,10210[,<txid>]物模型数据发送成功txid_mode配置项开启后返回txid
4,10220[,<txid>]定位数据发送成功txid_mode配置项开启后返回txid
4,10230[,<txid>]设备状态发送成功txid_mode配置项开启后返回txid
4,10240[,<txid>]设备信息发送成功txid_mode配置项开启后返回txid
4,10250[,<time>,<time_zone>,<timestamp>]NTP 信息发送成功txid_mode配置项开启后返回txid
4,10300[,<txid>]透传数据发送失败txid_mode配置项开启后返回txid可能性一：设备发送数据长度与命令指定数据长度相异，检查发送数据的长度是否正确
可能性二：设备发送数据长度大于模组所支持的最大发送长度
可能性三：设备没有连接平台，检查设备是否处于已连接上平台状态
4,10310[,<txid>]物模型数据发送失败txid_mode配置项开启后返回txid可能性一：设备发送数据长度与命令指定数据长度相异，检查发送数据的长度是否正确
可能性二：设备发送数据长度大于模组所支持的最大发送长度
可能性三：设备没有连接平台，检查设备是否处于已连接上平台状态
4,10320[,<txid>]定位数据发送失败txid_mode配置项开启后返回txid
4,10330[,<txid>]状态数据发送失败txid_mode配置项开启后返回txid
4,10340[,<txid>]设备信息发送失败txid_mode配置项开启后返回txid
4,10350[,<txid>]NTP 信息发送失败txid_mode配置项开启后返回txid
4,10400表示透传数据发送被拒绝
4,10410表示物模型数据发送被拒绝可能性一：设备发送数据长度与命令指定数据长度相异，检查发送数据的长度是否正确
可能性二：设备发送数据长度大于模组所支持的最大发送长度
可能性三：设备没有连接平台，检查设备是否处于已连接上平台状态
4,10420表示定位数据发送被拒绝

5：接收数据操作 ​

事件标识,事件码描述备注处理方式
5,10200URC中紧跟[,<length><\r\n><data>]表示收到下发的透传数据。 下行数据为非缓存模式时，收到数据将直接下发下行数据为非缓存模式时，收到数据将直接下发
5,10210URC中紧跟[,<length><\r\n><data>]表示收到下发的物模型数据。下行数据为非缓存模式时，收到数据将直接下发
5,10211URC中紧跟,<PkgID>,<ID1>[,<ID2>...]表示收到物模型查询命令。<PkgID> 平台下发的请求包ID；<ID> 物模型ID ；
5,10212URC 中紧跟,<PkgID>,<length>,[<data>]表示收到下发的物模型服务数据。下行数据为非缓存模式时，收到数据将直接下发
5,10428设备接收缓存过多导致限流设备缓存过多，需及时读取缓存数据
5,10473收到数据但长度超过设备缓存限制，接收失败平台下发数据过长，检查平台下发数据长度

6：注销操作 ​

事件标识,事件码描述
6,10200注销成功（断开连接成功）
6,10201子设备注销成功（断开连接成功）

7：OTA 操作 ​

事件标识,事件码描述参数说明处理方式
7,10700URC中紧跟,<componentNo>,<sourceVersion>,<targetVersion>,<batteryLimit>,<minSignalIntensity>,<useSpace>表示有升级任务<componentNo> 组件标识；
<sourceVersion> 源版本；
<targetVersion> 目标版本；
<batteryLimit> OTA升级最小电量；
<minSignalIntensity> OTA升级最小信号强度；
<useSpace> OTA升级需要磁盘空间；
7,10701URC中紧跟[,"<componentNo>",<length>,"<MD5>",<CRC>]表示设备开始下载固件包<componentNo> 组件标识；
<length> OTA升级固件包大小；
<MD5> OTA升级固件包md5值；
7,10702固件包下载中
7,10703URC中紧跟[,"<componentNo>",<length>,<startaddr>,<piece_length>]表示固件包下载完成<componentNo> 组件标识；
<length> OTA升级固件包大小；
<startaddr> 开始下载位置；
<piece_length> 当前文件块大小；
7,10704固件包更新中
7,10705更新固件成功
7,10706更新固件失败可能性一：平台升级计划目标版本配置错误，检查升级计划中的目标版本填写是否正确
可能性二：升级过程中网络中断，检查OTA升级途中是否有网络或者信号中断现象
可能性三：平台上传的升级包不正确，检查平台上传的升级包是否有效
7,10707首个设备操作结果广播
7,10708等待子设备操作超时

8：平台事件 ​

事件标识,事件码描述处理方式
8,10428设备高频消息导致限流设备发送消息过于频繁，请降低发送数据频率
8,10429超过单设备激活数量或者每日请求数导致限流设备激活码不足，您可以联系当地销售进行价格咨询，由销售为您推进整个激活码的购买流程。
8,10442子设备注销失败

9：唤醒事件 ​

事件标识,事件码描述
9,10200设备从深度睡眠模式被唤醒
9,10300唤醒设备从深度睡眠模式错误

10：注销操作 ​

事件标识,事件码描述
10,10200子设备注销成功

30：数采事件 ​

事件标识,事件码描述
30,0数采数据发送成功
30,1数采数据发送失败
30,2数采数据发送限流
30,3数采数据发送失败，并重试
30,10连接数采服务器失败
30,11本次传输异常结束
30,12数采通道未开启
30,13连接服务失败，并重试
30,20数采通道已关闭

版权所有 ©2023 上海移远通信技术股份有限公司 版权所有