子设备上下线

更新时间:2022-10-17 07:53:38下载pdf

子设备的上下线需要网关代理上报。

网关可逐个或批量上报子设备的在线状态。在上报子设备在线状态之前,需要建立网关和子设备的拓扑关系。网关上报子设备在线状态时,云端会校验网关和子设备的拓扑关系,并进行身份验证,确定网关是否有权代理子设备上下线。

  • 网关代理子设备上报在线状态之前,需要建立网关和子设备的拓扑关系。
  • 子设备批量上下线是异步的操作,云端无响应。

本文主要介绍子设备上下线相关的协议内容。

子设备上线

在建立拓扑关系的前提下,网关可以代理子设备上线。

设备发送消息

topic:tylink/${deviceId}/device/sub/login

{
    "msgId":"45lkj3551234001",
    "time":1626197189600,
    "data":[
      "123455asdf",
      "123456tyiy"
    ]
}

参数说明

类型 说明 必选 备注
${deviceId} string 设备 ID 发起子设备上线的网关设备 ID。
version string 协议版本 默认 1.0,仅有 1.0。
msgId string 消息 ID 总长度不超过 32 位的字符,请求和响应消息通过该值建立应答关系。
time number 消息时间戳 消息发送时的 Unix 时间戳,10 位秒级或 13 位毫秒级。
data array 上线的子设备 deviceId 列表 多个子设备的 deviceId 列表,设备数量不超过 100。

子设备下线

在建立拓扑关系的前提下,网关可以代理子设备下线。

设备发送消息

topic:tylink/${deviceId}/device/sub/logout


{
    "msgId":"45lkj3551234001",
    "time":1626197189600,
    "data":[
      "123455asdf",
      "123456tyiy"
    ]
}

参数说明

参数 类型 说明 必选 备注
${deviceId} string 设备 ID 发起子设备下线的网关设备 ID。
version string 协议版本 默认 1.0,仅有 1.0。
msgId string 消息 ID 总长度不超过 32 位的字符,请求和响应消息通过该值建立应答关系。
time number 消息时间戳 消息发送时的 Unix 时间戳,10 位秒级或 13 位毫秒级。
data array 下线的子设备 deviceId 列表 多个子设备的 deviceId 列表,设备数量不超过 100。