本文描述网关以及其连接的子设备如何接入物联网平台LP(Link Platform)。

网关接入LP

说明:

  • 子设备:指没有集成Link SDK的设备,这些设备通常没有IP地址,不能直接与阿里云物联网平台建立连接,例如Zigbee设备、KNX设备。
  • 网关:集成了Link SDK的设备,可以与物联网平台建立连接,并代理子设备连接到阿里云物联网平台。
  • 网关接入网络:网关往往使用zigbee、KNX、Zwave、RS485等协议连接子设备,网关用于连接子设备的网络称为网关的接入网络。

首先网关需要连接到阿里云物联网平台,然后当一个子设备连接到网关的接入网络后,由网关告知物联网平台该网关代理了该子设备,子设备的身份认证、上线与离线均由网关告知物联网平台,子设备上传的数据、云端发送给子设备的数据均通过网关进行中转。

当网关告知物联网平台代理了某个子设备后,物联网平台会将该子设备加入到网关的子设备拓扑表。

云端开发

网关

  • 创建网关产品

    开发者需要在物联网平台创建产品,定义产品功能,指定产品联网方式,指定产品的节点类型为网关设备

    网关设备

    物联网平台会为网关产品生成产品标识(ProductKey)以及产品密钥(ProductSecret),ProductKey的长度为11字节、ProductSecret为32字节。 详细内容请参见创建网关产品操作过程

    说明 开发者开发时需要将产品的ProductKey、ProductSecret复制保存以备用。
  • 创建网关调试设备

    开发者需要在物联网平台创建调试设备,云平台会自动为产品生成设备密钥(DeviceSecret)和设备标识(DeviceName),这两个数值的长度最长为32字节。 详细内容请参见创建调试设备操作过程

    说明 开发者开发时需要将设备的DeviceSecret、DeviceName复制保存以备用。

    在本文中使用“设备身份认证信息”统称ProductKey、ProductSecret、DeviceName、DeviceSecret。

  • 网关云端数据处理

    网关上报数据到物联网平台之后,开发者可以将数据转发到自己的业务服务器,或者在物联网平台上将该数据转发到另外的设备。

    需要发送数据给网关时,开发者需要调用物联网平台提供的接口将数据发送给设备。

子设备

  • 创建子设备产品

    网关接入的每种子设备产品都需要在物联网平台创建一个产品,指定产品的节点类型为网关子设备

    网关子设备

    产品创建之后,物联网平台会为子设备生成ProductKey,开发者需要对子设备的功能进行定义。详细内容请参见创建子设备产品操作过程

  • 创建调试子设备

    每个子设备都需要自己的设备身份认证信息,创建子设备产品之后可以得到子设备完整的身份信息。 详细内容请参见创建调试设备操作过程

  • 子设备云端数据处理

    子设备通过网关上报数据到物联网平台后,开发者需要在云端对子设备上报的数据进行处理。

    云端需要发送数据给子设备时,开发者调用物联网平台提供的接口将数据发送给子设备。

网关开发

不论是网关自身的功能、还是子设备的功能,都是在网关上进行实现的,子设备上无需集成Link SDK,因此在子设备上无开发工作。

支持网关开发的SDK类型

开发者需要根据网关开发使用的语言或平台进行网关的功能开发,不同语言SDK的使用方式存在差异,下面是支持的语言或平台的SDK获取以及编程文档链接,推荐用户先阅读完本文之后再阅读相关语言或平台的SDK的开发文档:

网关自身功能的开发

这里提到的网关自身功能,包括网关连接物联网平台时对网关的身份认证、以及其它一些功能实现,例如如果网关也是一个灯,那么也需要实现灯的状态变化的上报、以及来自物联网平台灯开关命令的处理。

因此网关首先需要连接到物联网平台,然后才能进行子设备的添加、删除以及状态报告。

SDK依赖

下面是需要网关厂商在产品上实现而不是SDK提供的功能:

  • 如果网关上联网络接口是Wi-Fi,那么设备商需要实现Wi-Fi热点的SSID或密码输入功能,让网关可以连接到Wi-Fi网络。
  • 通过DHCP Client从路由器获取IP地址,或者手动指定IP地址功能。
  • 如何对子设备进行发现、如何将子设备接入网关、如何发现子设备离线、如何从子设备接收数据、如何将数据发送到子设备,都需要由网关厂商实现。SDK只负责网关与阿里云IoT之间的通信,不涉及网关与子设备之间的通信。

开发者需要设计如何保存网关的产品标识(ProductKey)、产品密钥(ProductSecret)、设备标识(DeviceName)、设备密钥(DeviceSecret)到每个设备上,建议开发者可以将这些信息加密之后存放到网关的Flash的某个位置或者某个文件中,当网关上电后将这些信息从指定的地方读取出来之后传递给SDK。

网关开发方式

目前很多的网关仅仅实现将子设备连接到网络的功能,本身并没有特殊的功能。如果网关本身也有特殊的功能,例如网关除了连接子设备之外,自己也还是一个灯,那么网关自己的功能也需要进行开发。

网关自身功能的开发以下几种方式:

  • 基于Topic进行数据收发

    开发者在物联网平台产品定义时添加Topic,指定用于数据发布(指网关的数据上报)的Topic、订阅Topic(网关从云端接收数据)或者“发布和订阅”,开发者根据网关的需要进行Topic的定义以及Topic上传输的数据格式的定义。

  • 基于物模型方式开发网关功能

    开发者在物联网平台可以使用物模型来定义产品,也即定义产品支持的属性、服务、事件,其中:

    • 属性表示设备支持的某个可读、或者可读可写的参数,例如灯的亮度。
    • 服务表示一个设备支持的功能,例如让一个设备重启。
    • 事件是设备主动上报的某种情况发生的信息,例如有人在撬锁时智能锁可以上报一个暴力撬锁的事件到云端进行报警。

    使用物模型开发设备的好处在于设备的功能以JSON格式进行了格式化,设备与云端交互数据的可读性较好,并且对云端服务而言编程比较友好,阿里云IoT也对常见的产品进行了物模型定义,开发者可以使用阿里云定义的物模型进行设备开发,这样当有应用服务商想对设备进行管理时,只要将物模型定义告知服务商即可。

网关上子设备接入逻辑

对于子设备接入而言,SDK提供了一些接口用于子设备身份认证、子设备在线和离线状态上报、子设备数据上报、子设备云端下行数据处理,其它很多逻辑是需要网关厂商去实现的。

下文描述网关在接入子设备时建议的各种逻辑。

初始化

建议网关需要维护的数据结构(由网关厂商实现):

  • 网关本地拓扑列表(LocalTopoList),用于记录网关已经告知物联网平台代理的子设备、以及已代理子设备的身份认证信息,这些信息是需要持久化的,也即网关reboot之后这些信息仍然存在。
  • 网关已连接子设备列表(LocalDevList),表示当前已经连接到了网关所在接入网络的子设备,这些子设备可能已经被网关告知物联网可能,也可能未被告知物联网平台,该列表无需持久化。
  • 网关已本地删除子设备列表(RemovedDevList),表示在网关与物联网平台断开连接期间,用户通过网关的某种操作本地删除的子设备列表,这些被删除的设备网关尚未告知物联网平台,该列表需要持久化。

网关上电之后需要执行如下操作:

  • 构建这些数据结构。
  • 去获取网关的IP地址。
  • 当设备获取到IP地址之后,调用SDK的接口去连接物联网平台。

子设备身份认证信息获取

很多的子设备是无法存储阿里云物联网平台分配的身份认证信息的,因此子设备的身份认证信息都需要保存在网关上。

子设备往往有自己定义的产品型号、设备唯一标识(MAC地址、序列号等),因此网关上需要实现子设备产品型号到物联网平台ProductKey、ProductSecret的映射,也需要实现基于设备的唯一标识到物联网平台DeviceName、DeviceSecret的映射。子设备身份认证信息获取

如果网关在部署时,可以预先把将会连接的子设备的型号、设备标识以及与其对应的身份认证信息进行输入,那么当网关通过接入网络接入一个新的子设备时,调用SDK提供的接口告知物联网平台对该子设备进行代理。

如果网关的使用者无法将将要连接的子设备的型号、设备标识与其对应的身份认证信息进行预配置,那么网关就需要实现接入了一个子设备(将会获取到型号和设备DevID)时如何获取该子设备的身份认证的逻辑。阿里云也提供了一种方案供网关厂商参考和选用:

  • 网关的固件需要记录自己支持的子设备型号与该子设备产品的ProductKey、ProductSecret的映射表,该映射表由网关厂商自行实现。
  • 将设备的标识(DevID)用做设备在阿里云物联网平台的DeviceName,网关厂商需要将设备的标识预先上传到物联网平台,此时设备的标识在物联网平台起到一个白名单的作用。
  • 当网关通过接入网络连接一个新的子设备时,通过网关与子设备之间定义的协议获取设备的型号和设备标识,获得该产品对应的ProductKey、ProductSecret,然后调用SDK的接口使用ProductKey、ProductSecret和DeviceName去物联网平台判断该子设备是否位于白名单中,如果是,那么物联网平台将把子设备的DeviceSecret发送给网关。
    注意 物联网平台将子设备的DeviceSecret发送给网关后,网关再次来获取DeviceSecret将会失败。
  • 当网关收到子设备返回的子设备的DeviceSecret之后,就具有了该子设备完整的身份认证信息,再调用SDK提供的接口将子设备添加到物联网平台。
    注意 网关需要将子设备的DeviceSecret持久化,也即网关重启之后无需再次到物联网平台去获取子设备的DeviceSecret。

网关与物联网平台建立连接之后的逻辑

当网关连接到物联网平台之后,SDK会告知网关连接已建立,此时建议网关执行以下操作:

  • 判断子设备是否已被用户通过物联网平台删除

    场景描述:网关关机,然后用户通过手机APP或者物联网平台的接口将某个子设备从网关下删除,此时物联网平台将会把该子设备从网关的拓扑表删除,但是网关因为关机接收不到这个信息,因此网关还会认为这个设备已经被添加到了物联网平台。

    网关调用SDK的接口从物联网平台拉取网关的拓扑表,对比网关上本地的拓扑表,如果有某个子设备在网关本地的拓扑表中、而不在云端获取的拓扑表中,表示用户已经通过物联网平台提供的接口删除了这个子设备,网关需要将将该子设备从网关本地拓扑表中移除,并将该子设备从网关的接入网络删除

  • 已代理子设备上线通知

    将仍然存在于网关本地拓扑表中的当前在线子设备调用SDK接口通知物联网平台设置子设备状态为在线状态,离线子设备可以不用通知物联网平台,因为当网关离线的时候物联网平台会将该网关连接的所有子设备的状态设置为离线状态。

  • 未代理子设备添加通知

    如果一个设备已经连接到了网关的接入网络,但是并不在网关的本地拓扑表中,此时可以调用SDK提供的接口告知物联网平台网关需要代理该子设备。当子设备代理成功之后,将该设备添加到网关的本地拓扑表中。

  • 告知物联网平台移除已删除子设备

    场景描述:网关与物联网平台的连接断开,例如网关连接路由器的网线被拔掉,然后用户又通过网关的web server、Telnet、或者某种操作将某个子设备删除,此时物联网平台不知道设备被删除。

    将已删除列表中的子设备调用SDK的接口告知物联网平台删除该子设备的拓扑,然后将子设备从网关本地的已删除子设备列表中删除。

网关与物联网平台的连接断开

当网关与物联网平台的连接断开后,网关如果有子设备被用户在网关上删除(不是通过物联网平台执行的删除),网关需要将这些子设备记录到网关的本地已删除子设备列表,并把该子设备从网关的本地拓扑表和已连接子设备表中删除。

网关添加了新子设备

场景描述:网关的接入网络增加了一个新的子设备。

网关的接入网络中添加了新的子设备时,需要将子设备加入到网关的已连接子设备列表。

  • 如果网关与与物联网平台的连接是已建立,则调用SDK的接口告知物联网平台添加子设备。如果添加成功:
    • 调用SDK的接口告知物联网平台将该子设备设置为在线状态。
    • 将该子设备也加入网关的本地拓扑表。
  • 如果网关尚未建立与物联网平台的连接,无需做特殊操作,等待建立连接之后通知物联网平台去添加子设备以及上报子设备状态。

网关删除子设备

场景描述:当用户通过网关提供的命令或者某种操作方式将某个子设备从网关的接入网络删除。

  • 首先,将子设备从已连接子设备列表删除。
  • 其次,如果子设备在网关的本地拓扑表中,将子设备加入已删除子设备列表。
  • 然后,如果网关与物联网平台已建立连接,告知物联网平台去删除该子设备,并将该设备从已删除子设备列表删除;如果网关与物联网平台未建立连接,则无需处理。

子设备上线

场景描述:一个曾经连接到网关的子设备连接到网关的接入网络。

  • 首先将其加入网关的已连接子设备列表,并设置子设备的状态为在线状态。
  • 如果网关与物联网平台处于连接状态:
    • 如果子设备不在网关的本地拓扑表中,调用SDK的接口让物联网平台将该子设备添加到网关的拓扑表,添加成功将该子设备加入网关的本地拓扑表,再调用SDK的接口告知物联网平台该子设备上线。
    • 如果子设备在网关的本地拓扑表中,就调用SDK的接口告知物联网平台子设备上线。

子设备离线

  • 设置子设备的状态为离线状态。
  • 如果子设备位于网关的本地拓扑表中,且网关与物联网平台处于连接状态,则调用SDK的接口告知物联网平台设备离线。

子设备数据上报

网关收到子设备的数据时,使用MQTT Topic或者基于物模型的方式对数据编码后发送到物联网平台。

来自云端子设备数据处理

网关收到物联网平台发送给某个子设备的数据,需要将数据解析出来之后,再发送给子设备,该数据如何编码以及如何发送给子设备由网关实现。

参考

下文列出与网关编程相关的文档链接。

基于Ubuntu+C+MQTT Topic的数据收发实现

请参见快速体验中的“以MQTT Topic方式接入设备”,该章节描述了设备在Ubuntu上使用C SDK将数据发送到物联网平台、然后将该数据接收回来的实现案例。

更多详细内容请参见自定义MQTT Topic编程

基于Ubuntu+C+MQTT+物模型的加法器实现

请参见快速体验中的“以物模型编程方式接入设备”,该章节描述了在Ubuntu上使用C SDK实现的一个支持加法运算的设备逻辑。

物模型编程以及相关API说明,请参见C语言的物模型编程指南

注意 非C语言的SDK也有网关编程相关文档,本处单独给出C语言的链接是因为当前网关主要使用嵌入式Linux、并使用C语言开发为主。

基于Ubuntu+C+MQTT的OTA实现

OTA用于设备固件升级,C SDK的目录src\ota\examples\ota_example_mqtt.c描述了OTA的实现示例。相关API说明和子设备OTA的描述,请参见C语言OTA的说明文档

基于Ubuntu+C+MQTT的动态注册实现

如果在产线上给每个网关烧录ProductKey、ProductSecret、DeviceName、DeviceSecret,由于每个网关的DeviceName和DeviceSecret每个设备烧写的内容都是不一样的,厂商需要对产线进行改造。有的厂商不愿意进行产线工具改造,因此阿里云IoT提供了动态注册用于解决该问题,网关上烧写网关设备的ProductKey、ProductSecret,并使用设备的MAC地址、或者序列号作为设备标识(DeviceName),来避免对产线工具进行改造。

C SDK的目录src\dynamic_register\examples\dynreg_example.c示例了如何动态获取设的DeviceSecret,然后再连接阿里云物联网平台。

更多详细内容请参见C语言的设备认证编程文档中的“一型一密”。

设备量产

下文描述相关设备添加。

网关

当网关功能调试运行正常之后,设备进入量产阶段。设备量产是指设备厂商将产品的固件烧录到每个设备,并将每个设备的身份认证信息烧录到每个设备的过程。

开发者需要对自己的产线进行设计来将设备的身份信息可以快速的烧录到每个设备中。

开发者需要在阿里云物联网平台为所有的网关设备申请设备身份信息,操作步骤为在设备管理 > 设备,选中相应产品后单击批量添加批量获取设备身份信息。

子设备

子设备接入阿里云物联网平台虽然没有特殊的开发,也需要为每个子设备申请设备身份信息,开发者需要在阿里云物联网平台为所有的网关设备申请设备身份信息,操作步骤为在设备管理 > 设备,选中相应产品后单击批量添加批量获取设备身份信息。

如果子设备使用动态注册方式,子设备厂商需要将子设备的设备标识上传到物联网平台。