20.dock-device-management

功能概述

设备管理功能支持设备向云端上报拓扑信息、推送设备属性、以及云端对设备的属性进行设置。让用户可以在云端查看以及调整设备状态，更为方便地展开工作。

交互时序图

sequenceDiagram
participant object as Aircraft
participant client as DJI Dock
participant server as Cloud Server

note over object,server: 设备上线
object ->> client: 设备与网关通信连接，设备上线
client ->> server: 设备拓扑更新 Topic: sys/product/{gateway_sn}/status<br/>Method: update_topo

loop  osd属性 0.5HZ 定频推送
object ->> client: 飞行器属性推送
client ->> server: 设备（飞行器）属性推送 Topic: thing/product/{device_sn}/osd
client ->> server: 设备（机场）属性推送 Topic: thing/product/{device_sn}/osd
end

opt state属性 事件性上报
object ->> client: 飞行器属性推送
client ->> server: 设备（飞行器）属性推送 Topic: thing/product/{device_sn}/state
client ->> server: 设备（机场）属性推送 Topic: thing/product/{device_sn}/state
end

server ->> client: 设备属性设置 Topic: thing/product/{gateway_sn}/property/set
client ->> object: 变更命令下发
object ->> object: 设备属性变更
object ->> client: 飞行器响应
client -->> server: 设备端响应 Topic: thing/product/{gateway_sn}/property/set_reply

note over object,server: 设备下线
object --x client: 设备与网关设备通信断开，设备下线
client ->> server: 设备拓扑更新 Topic: sys/product/{gateway_sn}/status<br/>Method: update_topo

接口详细实现

• 飞行器设备属性

• 机场设备属性

• 设备管理（MQTT）

  • 设备拓扑更新 网关设备感知到与子设备通信的连接与断开，会向云端上报子设备的上下线状态。协议中type与sub_type的值请参照产品支持章节找到对照。

  • 设备属性推送 设备属性划分为定频数据（osd）与状态数据（state），osd 属性会以 0.5 HZ定频上报，state属性会在属性变化时上报。不同的设备属性我们提供了不同的处理策略，使用不同的topic上报。设备属性分别介绍在：飞行器设备属性、机场设备属性与遥控器设备属性章节。

  • 设备属性设置

    • 当前设备属性的设置没有实现全面覆盖，我们将在后续逐渐实现。

    • 在设备属性章节中通过“accessMode”标识属性的读写状态，标识为“rw”表示属性可以被设置。

    • 设备属性设置只支持单个属性字段的设置。譬如飞机限远状态（distance_limit_status）属性包括是否开启限远（state）和限远距离（distance-limit）两个字段。在做飞机限远状态的属性设置时，设置指令需要发送两次。