文档

SL 651协议消息示例

更新时间:

对于SL 651协议云网关设备,设备上下线、上报数据消息,可通过物联网平台消息转发的云产品流转功能转发到服务端(用户的服务器)。设备上报数据消息可通过消息转发的AMQP订阅功能推送至服务端。本文介绍消息转发的使用说明,及对应消息的Topic和数据格式。

设备上下线状态

Topic:/sys/${productKey}/${deviceName}/device/status/notify

  • 设备上线的数据格式:

    {
        "protocol": "sl651",
        "status":"online",
        "iotId":"4z819VQHk6VSLmmBJfrf00107e****",
        "productKey":"al12345****",
        "deviceName":"deviceName1234",
        "time":"2018-08-31 15:32:28.205",
        "utcTime":"2018-08-31T07:32:28.205Z",
        "lastTime":"2018-08-31 15:32:28.195",
        "utcLastTime":"2018-08-31T07:32:28.195Z",
        "clientIp":"192.0.2.1"
    }
  • 设备下线的数据格式:

    {
        "protocol": "sl651",
        "status":"offline",
        "iotId":"4z819VQHk6VSLmmBJfrf00107e****",
        "offlineReasonCode":427,
        "productKey":"al12345****",
        "deviceName":"deviceName1234",
        "time":"2018-08-31 15:32:28.205",
        "utcTime":"2018-08-31T07:32:28.205Z",
        "lastTime":"2018-08-31 15:32:28.195",
        "utcLastTime":"2018-08-31T07:32:28.195Z",
        "clientIp":"192.0.2.1"
    }

参数说明:

参数

类型

说明

protocol

String

SL 651协议云网关,取值sl651

status

String

设备状态。

  • online:上线。

  • offline:离线。

iotId

String

设备在平台内的唯一标识。

offlineReasonCode

Integer

设备下线时,返回的错误码。详细说明,请参见设备行为错误码

productKey

String

设备所属产品的唯一标识。

deviceName

String

设备名称。

lastTime

String

该参数为历史存量字段,已无实际意义。

utcLastTime

String

time

String

设备上、下线的时间。

收到消息的顺序不是实际设备上下线时间排序。设备上下线顺序需按照time具体值排序。

例如,您依次收到3条消息:

  1. 上线:2018-08-31 10:02:28.195

  2. 下线:2018-08-31 10:01:28.195

  3. 下线:2018-08-31 10:03:28.195

这3条消息展示了,设备先下线,再上线,最后下线的过程。

utcTime

String

设备上、下线的UTC时间。

clientIp

String

设备公网出口IP。

设备上报数据

Topic:/sys/${productKey}/${deviceName}/device/message/uplink

payload:
{
    header:{
        telemetryAddress:""
    },
    body:{
        data:"dGVzdDEyMw=="
    }
}

参数名称

数据类型

描述

header

Object

消息头数据。

telemetryAddress

String

遥测站地址。

body

Object

消息体数据,data数据格式为Base64编码格式。