网关与子设备（联通用户专用）

概述

物联网平台支持设备直连，也支持设备挂载在网关上，作为网关的子设备，由网关直连。

针对未实现TCP/IP协议栈的设备，由于无法直接同物联网平台通信，它需要通过网关进行数据转发，如下图所示。

接入流程

Agent Lite SDK提供相关的接口，开发者调用这些接口网关实现与物联网平台的对接。不同语言的SDK的接口名称不一样，每个接口功能请参见Agent Lite SDK 使用指南（C）、Agent Lite SDK 使用指南（JAVA）、Agent Lite SDK 使用指南（Android）。

1、网关调用Agent Lite SDK 的初始化接口，初始化Agent Lite资源。

2、在物联网平台的控制台上上传网关的产品模型，并注册网关。

3、网关第一次接入物联网平台时需要进行绑定操作，从而将网关与平台进行关联。需先修改配置文件里的设备固有信息（verifyCode和其他必要的设备信息），然后调用绑定接口设置绑定配置，并绑定网关。

4、网关绑定成功后，需要进行登录操作。网关先调用SDK接口配置所需的登录信息，然后调用登录接口进行网关登录。

5、在物联网平台的控制台上上传子设备的产品模型。

6、在网关登录成功后，网关调用添加非直连设备接口，填写设备相关信息（与产品模型定义一致），添加子设备到物联网平台（同时网关侧完成和子设备之间的对接，并上电）。添加成功后，在物联网平台上就能查看添加的子设备（如何查看？）。

用户也可以通过控制台添加子设备，如何添加？

7、子设备添加完后，一般情况下在物联网平台上显示是“离线”状态。所以在子设备添加成功后，或者在子设备上报数据前，网关要调用“设备状态更新”接口进行设备状态更新。

子设备的状态表示子设备接入网关的状态，由网关上报到物联网平台进行状态的刷新；如果网关不能正常上报子设备的状态信息到物联网平台，则展示的子设备状态不会刷新。例如：某子设备通过网关接入到物联网平台，子设备状态为在线状态，如果此时网关与物联网平台断开连接，则网关不能上报子设备的状态到物联网平台，该子设备的状态会一直显示在线。

8、网关调用“设备服务数据上报”接口上报网关和子设备的数据，接口里的参数填写网关和子设备的相关设备信息。

9、网关调用“设备命令接收”接口，接收并处理应用服务器或物联网平台下发的命令。

10、应用服务器调用删除子设备接口，给网关下发删除子设备命令，网关调用SDK上的“设备删除”接口删除在物联网平台上的子设备信息。并向平台返回删除结果。

网关如何接入物联网平台？

通过在网关上集成Agent Lite SDK, 设备将数据上报给网关，通过网关转发到华为物联网平台，网关接入物联网平台的开发指南请参见设备通过网关接入平台。

物联网平台上如何添加子设备？

方式1

当网关接入物联网平台后，在网关上通过调用Agent Lite的添加非直连设备接口，完成子设备接入到物联网平台。

方式2

登录物联网平台控制台，点击右上角“进入设备管理服务”。单击左下角，进入“设备 > 所有设备”页面，在设备列表中，单击具体的网关进入到网关的详情页面，进入“设置”页签。启用“添加设备模式（NWI）”。

只有在网关的产品模型中定义了“DISCOVERY”的命令，才会在控制台上显示该功能。

该功能用于在物联网平台上添加网关下接入的子设备的场景。子设备通过Z-wave、ZigBee协议接入网关的情况下，需要物联网平台向网关下发开启发现子设备的命令，然后网关与子设备进行匹配和添加。点击“启用”按钮，物联网平台向网关下发发现子设备的命令，如果在一段时间内（一般为180秒，具体请以网关的能力为准）没有发现子设备，网关会自动关闭发现子设备的开关；如果在打开发现子设备的时间窗内，发现并添加了一个子设备后，网关也会自动关闭发现子设备功能。如果需要添加多个子设备，可以在物联网平台上再次向网关下发打开发现子设备的命令。

查看子设备

1. 登录物联网平台控制台，点击右上角“进入设备管理服务”。
2. 单击左下角，进入“设备 > 所有设备”页面，在设备列表中，单击具体的网关进入到网关的详情页面，选择“子设备”页签。
3. “子设备”页签呈现通过该网关方式接入到物联网平台的设备，可以查看子设备的状态、设备ID、设备类型等信息。
   

   

   子设备的状态表示子设备接入网关的状态，由网关上报到物联网平台进行状态的刷新；如果网关不能正常上报子设备的状态信息到物联网平台，则展示的子设备状态不会刷新。例如：某子设备通过网关接入到物联网平台，子设备状态为在线状态，如果此时网关与物联网平台断开连接，则网关不能上报子设备的状态到物联网平台，该子设备的状态会一直显示在线。

4. 在子设备页签中，单击具体的子设备，可以查看子设备的设备详情、历史上报数据、查看操作记录。