快速开始

本教程会用简单的示例来展示 Zeus-IoT 的大部分常用功能。可以快速了解到如何:

  • 安装 Zeus-IoT 平台;

  • 将设备接入平台;

  • 定义告警规则、设备联动规则;

  • 通过设备调试来模拟上报数据;

  • 配置产品,以复用属性、事件、服务、告警规则的定义。

为保持本教程的简洁,您仅会接入一个温度传感器和一个空调控制器。

  • 温度传感器有以下要素:

    • 属性:温度。

    • 告警规则:温度过高。

  • 空调控制器有以下要素:

    • 属性:电源状态。

    • 服务:制冷开机。

本教程最终将实现:

  • 获取温度传感器的温度;

  • 温度过高时发出告警;

  • 在温度过高且空调关机时,让空调制冷开机。

准备工作

需要有可访问的 Zeus-IoT 平台。最简单的是使用在线 Demo。也可以本地安装以进行更充分的体验。

使用在线 Demo

在线 Demo 的帐号信息如下:

  • 全局超级管理员的用户名是 Admin,密码是 zabbix ;

  • 示例租户管理员的用户名是 tenant1admin,密码是 111111

为了使用在线 Demo完成本示例,请用上面的示例租户管理员进行登录。

本地安装

请参照安装指南来本地安装 Zeus-IoT 平台。Linux 用户可用下面的命令来一键安装:

步骤1:添加产品

您会创建符合本教程目的的最简产品,请见下面的说明。产品的详细说明请见产品配置

步骤1.1:创建产品分类

  1. 进入产品管理产品分类列表页。点击创建

  2. 填写产品分类的名称,例如demo。点击保存

  3. 创建的产品分类会列在产品管理产品分类里。

步骤1.2:创建产品的空框架

  1. 进入产品管理产品列表页。

  2. 点击创建以创建产品演示温度传感器。填写产品的必填字段,设置产品IDdemo-temp产品名称演示温度传感器产品分类demo设备类型直连设备。点击保存

  3. 重复前一步,只是填写的属性略有不同,以创建产品演示空调控制器。设置产品IDdemo-acc产品名称演示空调控制器

  4. 上面新建的产品会列在产品管理产品里。

步骤1.3:添加产品属性

  • 给产品演示温度传感器创建属性温度。

    1. 进入产品管理产品列表页。点击产品名称演示温度传感器进入产品详情页,点击顶部的属性管理,再点击创建

    2. 设置属性名称温度,设置标识符temp,设置来源类型主动上报,设置数据类型小数,设置单位摄氏度/℃。点击保存

  • 给产品演示空调控制器创建属性电源状态。

    1. 进入产品管理产品列表页。点击产品名称演示空调控制器进入产品详情页,点击顶部的属性管理,再点击创建

    2. 设置属性名称电源状态,设置标识符power_status,设置来源类型主动上报,设置数据类型字符。点击保存

步骤1.4:添加产品服务

  1. 进入产品管理产品列表页。点击产品名称演示空调控制器进入产品详情页,点击顶部的服务管理,再点击创建

  2. 设置服务名称制冷开机,设置标识符power_on,设置调用方式异步。点击保存

步骤1.5:添加产品告警规则

  1. 进入产品管理产品列表页。点击产品名称演示温度传感器进入产品详情页,点击顶部的告警规则,再点击创建

  2. 设置告警名称温度过高,设置告警级别高级,设置启用告警规则启用,设置触发条件为满足下列任意条件:属性 温度 最新值 > 30。点击保存

步骤2:添加设备

为了简洁,您会通过平台页面来手动添加设备。请见下面的说明。详细的说明请见设备配置

步骤2.1:创建设备组

  1. 进入设备管理设备组列表页。点击创建

  2. 设置设备组名演示设备组。点击保存

  3. 创建的设备组会列在设备管理设备组里。

步骤2.2:创建设备

  • 创建设备温度传感器01。

    1. 进入设备管理设备列表页。点击创建

    2. 设置设备IDdevice_temp01,设置设备名称温度传感器01,设置产品演示温度传感器。点击保存

  • 创建设备空调控制器01。

    1. 进入设备管理设备列表页。点击创建

    2. 设置设备IDdevice_acc01,设置设备名称空调控制器01,设置产品演示空调控制器。点击保存

步骤3:配置设备告警规则/联动规则

若需要添加设备独有的告警规则或跨设备的联动规则,可以如下操作:

  1. 进入设备管理设备列表页,点击设备名称温度传感器01进入设备详情页,点击顶部的告警规则,再点击创建

  2. 设置告警名称温度01过高开启空调01,设置告警级别提示,设置启用启用

  3. 设置触发条件为满足下列所有条件:温度传感器01 属性 温度 最新值 > 26空调控制器01 属性 电源状态 最新值 = off

  4. 设置执行动作为:空调控制器 制冷开机

  5. 点击保存

注解

关于 联动规则告警规则 之间的关系:如果一条联动规则的触发条件包含多个设备,那么每个设备的告警规则里也都能看到该条联动规则。

步骤4:连接设备

为了简洁,您会在下一步用设备调试来实现。真实连接设备的详细说明请见开发指南里的设备接入协议

步骤5:触发告警规则&联动规则

为了触发前面定义的告警规则和联动规则,您可使用设备调试来模拟上报数据。告警规则与联动规则的触发逻辑是相同的。

  • 触发联动规则:

    1. 进入设备管理设备调试

    2. 在顶部设备下拉框内选择空调控制器01。在左侧会显示已选设备的所有属性,勾选电源状态并输入off,点击上报属性。此时在该设备详情页的属性内可以看到最新的属性值。

    3. 在顶部设备下拉框内选择温度传感器01。在左侧会显示已选设备的所有属性,勾选温度并输入26.1,点击上报属性。此时在该设备详情页的属性内可以看到最新的属性值。

    4. 此时会自动触发联动规则温度01过高开启空调01。在告警管理告警记录内可以看到该条记录。

  • 触发告警规则:

    1. 进入设备管理设备调试

    2. 在顶部设备下拉框内选择温度传感器01。在左侧会显示已选设备的所有属性,勾选温度并输入30.1,点击上报属性。此时在该设备详情页的属性内可以看到最新的属性值。

    3. 此时会自动触发联动规则温度过高。在告警管理告警记录内可以看到该条记录。