快速开始

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

安装 Zeus-IoT 平台；
将设备接入平台；
定义告警规则、设备联动规则；
通过设备调试来模拟上报数据；
配置产品，以复用属性、事件、服务、告警规则的定义。

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

温度传感器有以下要素：
- 属性：温度。
- 告警规则：温度过高。
空调控制器有以下要素：
- 属性：电源状态。
- 服务：制冷开机。

本教程最终将实现：

获取温度传感器的温度；
温度过高时发出告警；
在温度过高且空调关机时，让空调制冷开机。

准备工作
- 使用在线 Demo
- 本地安装
步骤1：添加产品
步骤2：添加设备
- 步骤2.1：创建设备组
- 步骤2.2：创建设备
步骤3：配置设备告警规则/联动规则
步骤4：连接设备
步骤5：触发告警规则&联动规则

准备工作 

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

使用在线 Demo 

在线 Demo 的帐号信息如下：

全局超级管理员的用户名是 Admin，密码是 zabbix ;
示例租户管理员的用户名是 tenant1admin，密码是 111111 。

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

本地安装 

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

#系统终端执行以下命令快速安装
## Centos7/Redhat7

curl -L https://github.com/zmops/zeus-iot/raw/develop/docs/rhel/quick-install.sh | bash

## Ubuntu 20.04

curl -L https://github.com/zmops/zeus-iot/raw/develop/docs/ubuntu/install.sh | bash

Zeus-IoT 平台的默认地址是 http://localhost:8080，默认用户名是 Admin ，默认密码是 zabbix 。

为了使用本地安装的环境完成本示例，请用上面的默认用户名登录即可。

步骤1：添加产品 

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

步骤1.1：创建产品分类 

进入产品管理→产品分类列表页。点击创建。
填写产品分类的名称，例如demo。点击保存。
创建的产品分类会列在产品管理→产品分类里。

步骤1.2：创建产品的空框架 

进入产品管理→产品列表页。
点击创建以创建产品演示温度传感器。填写产品的必填字段，设置产品ID为demo-temp，产品名称为演示温度传感器，产品分类为demo，设备类型为直连设备。点击保存。
重复前一步，只是填写的属性略有不同，以创建产品演示空调控制器。设置产品ID为demo-acc，产品名称为演示空调控制器。
上面新建的产品会列在产品管理→产品里。

步骤1.3：添加产品属性 

给产品演示温度传感器创建属性温度。
1. 进入产品管理→产品列表页。点击产品名称演示温度传感器进入产品详情页，点击顶部的属性管理，再点击创建。
2. 设置属性名称为温度，设置标识符为temp，设置来源类型为主动上报，设置数据类型为小数，设置单位为摄氏度/℃。点击保存。
给产品演示空调控制器创建属性电源状态。
1. 进入产品管理→产品列表页。点击产品名称演示空调控制器进入产品详情页，点击顶部的属性管理，再点击创建。
2. 设置属性名称为电源状态，设置标识符为power_status，设置来源类型为主动上报，设置数据类型为字符。点击保存。

步骤1.4：添加产品服务 

进入产品管理→产品列表页。点击产品名称演示空调控制器进入产品详情页，点击顶部的服务管理，再点击创建。
设置服务名称为制冷开机，设置标识符为power_on，设置调用方式为异步。点击保存。

步骤1.5：添加产品告警规则 

进入产品管理→产品列表页。点击产品名称演示温度传感器进入产品详情页，点击顶部的告警规则，再点击创建。
设置告警名称为温度过高，设置告警级别为高级，设置启用告警规则为启用，设置触发条件为满足下列任意条件：属性 温度 最新值 > 30。点击保存。

步骤2：添加设备 

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

步骤2.1：创建设备组 

进入设备管理→设备组列表页。点击创建。
设置设备组名为演示设备组。点击保存。
创建的设备组会列在设备管理→设备组里。

步骤2.2：创建设备 

创建设备温度传感器01。
1. 进入设备管理→设备列表页。点击创建。
2. 设置设备ID为device_temp01，设置设备名称为温度传感器01，设置产品为演示温度传感器。点击保存。
创建设备空调控制器01。
1. 进入设备管理→设备列表页。点击创建。
2. 设置设备ID为device_acc01，设置设备名称为空调控制器01，设置产品为演示空调控制器。点击保存。

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

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

进入设备管理→设备列表页，点击设备名称温度传感器01进入设备详情页，点击顶部的告警规则，再点击创建。
设置告警名称为温度01过高开启空调01，设置告警级别为提示，设置启用为启用；
设置触发条件为满足下列所有条件：温度传感器01 属性 温度 最新值 > 26，空调控制器01 属性 电源状态 最新值 = off；
设置执行动作为：空调控制器 制冷开机。
点击保存。

注解

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

步骤4：连接设备 

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

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

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

触发联动规则：
1. 进入设备管理→设备调试。
2. 在顶部设备下拉框内选择空调控制器01。在左侧会显示已选设备的所有属性，勾选电源状态并输入off，点击上报属性。此时在该设备详情页的属性内可以看到最新的属性值。
3. 在顶部设备下拉框内选择温度传感器01。在左侧会显示已选设备的所有属性，勾选温度并输入26.1，点击上报属性。此时在该设备详情页的属性内可以看到最新的属性值。
4. 此时会自动触发联动规则温度01过高开启空调01。在告警管理→告警记录内可以看到该条记录。
触发告警规则：
1. 进入设备管理→设备调试。
2. 在顶部设备下拉框内选择温度传感器01。在左侧会显示已选设备的所有属性，勾选温度并输入30.1，点击上报属性。此时在该设备详情页的属性内可以看到最新的属性值。
3. 此时会自动触发联动规则温度过高。在告警管理→告警记录内可以看到该条记录。