云网关协议SL 651的通信消息格式_物联网平台(IoT)-阿里云帮助中心

对于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条消息：上线：`2018-08-31 10:02:28.195`。下线：`2018-08-31 10:01:28.195`。下线：`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编码格式。