网关子设备

管理子设备的能力是网关的核心能力。

本文简单介绍如何使用 添加删除子设备 以及 控制子设备的在线离线 等子设备相关的能力。

添加子设备

网关的能力是转换不同设备间的通讯协议，可以让不具有联网能力的子设备通过网关连接上云端。
如果我们想要达到该目的，需要将子设备添加到网关下，建立子设备与网关的联系。

因此首先要做的是 添加子设备 到网关。

基础操作路径如下：

设置网关为配网模式（允许子设备加入) > 加入子设备 > 设置网关退出配网（禁止子设备加入）

添加子设备可以根据发起允许加入状态的对象不同，分为两种情况。

• 通过 App 发起添加。
• 通过 MCU 本地发起添加。

通过 App 添加

1. App 会将模组设置为允许入网状态，此时模组会通知 MCU（0x06命令），MCU 需要在此时进入配网模式，允许子设备入网。

2. MCU 进入配网模式后收到子设备加入的信息，MCU 发送子设备信息（0x08命令），将子设备加入网关。

3. 网关收到子设备信息后将设备注册到云端（从而可以在 APP 上显示），同时获取子设备的相关属性（DP 点）。

4. 网关注册成功后通知 MCU（0x13命令）添加完成。直到此步，子设备添加才真正添加成功。

5. App 退出配网页面，通知模组。模组发送关闭子设备入网命令（0x07命令）。

   

通过本地添加

1. MCU 使用命令0x1A通知模组，需要进入允许入网状态。
2. 模组收到命令后，模组发送允许子设备命令0x06通知 MCU 进入配网模式
3. MCU 进入配网模式后收到子设备加入的信息，MCU 发送子设备信息（0x08命令），将子设备加入网关。
4. 网关收到子设备信息后将设备注册到云端（从而可以在 App 上显示），同时获取子设备的相关属性（DP 点）。
5. 网关注册成功后通知 MCU（0x13命令）添加完成。直到此步，子设备添加才真正添加成功。
6. 网关根据步骤 1 中设置的时间（0x1A命令），到时间后发送0x07命令，通知 MCU 关闭子设备入网。您也可以通过 MCU 主动发送0x1A命令通知模组退出。模组会随即发送0x07命令通知 MCU 关闭子设备入网。
   

删除子设备

• 通过 App 删除
  通过 App 删除，App 会把删除命令发送给模组，模组收到后会删除存在自身的子设备信息并通过0x09命令通知 MCU（具体内容参照协议）。
• 通过 MCU 删除
  MCU 主动发起删除命令,MCU 发送0x19命令，告知模组删除指定子设备（具体内容参照协议），模组收到后执行删除操作，并通知删除结果。

子设备的在线离线管理

作为网关，需要管理网关下子设备的在线离线情况。
在一般情况下，网关采用心跳查询的机制来检测各子设备的状态。但同时也可由 MCU 主动设置子设备的在线状态。

心跳管理

模组采用心跳检测的模式来判断子设备的离线以及在线情况。
在子设备加入到网关后，模组会发送心跳检测指令（0x0A命令）来查询子设备的在线状况。MCU 收到心跳检测指令后，如果该子设备在线，则需要回复对应的帧。如果两个心跳周期都没有回复，那么该子设备会被网关设置为离线。

查询周期和子设备数量相关，子设备数量越多，子设备心跳查询间隔越频繁。查询机制见下表。

由 MCU 更新子设备状态

在大部分情况下，MCU 对子设备的在线与离线状态的感知更敏感，当子设备离线的时候，模组至少需要两次心跳查询的周期来判定子设备的离线。但对于 MCU 来说，子设备的离线在线情况，MCU 可以更快的感知到。在这种情况下，MCU 可以使用命令 0x2A 来直接将子设备设置为在线或离线的状态。具体可参见协议。