花卉养植系统

   下图是本案例除硬件连线外的3步导学，每个步骤中实现的功能请参考图中的说明。在硬件连线完成之后我们建议您先使用“一分钟上云体验”功能预先体验本案例的实际运行效果。

简介

   我们国家的现代农业和过去相比已经有了长足的进步,其中花卉养植监控系统也是高效农业的一个重要组成部分。

   花卉养植监控系统是一种可以改变植物生长环境、为植物生长创造最佳条件、避免外界四季变化和恶劣气候对其影响的场所。它以采光覆盖材料作为全部或部分结构材料，可在冬季或其他不适宜露地植物生长的季节栽培植物。花卉养植监控系统生产以达到调节产期，促进生长发育，防治病虫害及提高质量、产量等为目的。而花卉养植监控系统设施的关键技术是环境控制，该技术的最终目标是提高控制与作业精度。

   本章课程就以山茶花养植为例介绍如何打造一个最适合茶花生长的花卉养植系统。

   按照茶花的生长习性，最适宜茶花的生长环境因素主要有3个：

1. 温度：20~28度
2. 湿度：~70%
3. 光照：不能太强

   为了制造适合茶花生长的环境，本场景的示意图如下图所示，场景设计的行为如下：

1. 通过温度传感器测量环境温度，并在温度过高时打开空调进行降低环境温度
2. 通过湿度传感器测量环境湿度，并在湿度过低的时候控制加湿器进行加湿操作

准备

   本案例只需要如下硬件：

• ESP32一台
• SHT3X-DIS温湿度传感器一个
• RGB三色LED灯一个
• 杜邦线若干
• Micro-USB数据线一条

硬件连线图

   硬件连线图如下图所示：

   需要连接两颗LED模拟控制空调和加湿器的开关的功能此处就借助于ESP32上面外接的蓝色和绿色LED灯，其中：

• 蓝色LED模拟空调的开关
  
• 绿色LED模拟加湿器的开关
  

   根据ESP32的硬件连线图，可以得知如果要模拟控制空调打开，则需要打开P27（蓝色LED）；如需模拟控制加湿器打开，则需要打开P26（绿色LED）。

一分钟上云体验

• 打开“支付宝”扫描下图二维码

• 在完成上面的“硬件连线”步骤之后，点击“体验案例”按钮，即可立即体验本案例的实际运行效果。

物联网平台开发

开通公共实例

   对于第一次使用物联网平台的读者，需要开通实例以使用物联网平台的功能。这里可以使用免费的公共实例进行开发。

   在物联网平台中，左上角选择“华东2-上海”，点击“公共实例”，即可开通。

开通物联网平台功能之后，需要完成下面的4个步骤完成云端设备的设定：

1. 创建云端产品
2. 创建产品属性（物模型）
3. 创建云端设备（获取三元组）
4. 多设备场景联动设定

创建云端产品

   点击上图中的“公共实例”，即可进入控制台进行产品创建。然后，点击创建产品按钮，如下图所示。

   在新建产品设定页面按照下图所示，设定“产品名称”，选择所属的“标准品类”（如果创建的产品品类为非标品类，可以选择自定义品类），节点类型选择“直连设备”，联网方式选择“Wi-Fi”，数据格式选择“ICA标准数据格式”，检验类型和认证方式选择默认设定即可。还可以根据开发者自己的需求在“产品描述”页面添加针对此产品的描述。

   选择之后，点击“确认”按钮，即可完成产品创建。返回“产品”页面之后可以看到产品类表中会出现刚刚创建的“温湿度检测装置”的产品，如下图所示。

创建产品属性（物模型）

   点击上图中的“查看”按钮，即可看到产品信息，Topic列表，功能定义，数据解析等跟产品相关功能的设定。点开“功能定义”标签页，可以看到设备物模型定义。

物模型中的“地理位置”属性本案例后面的内容没有用到，读者可忽略。

   因为在创建产品的过程中选择了标准的产品品类，这里会出现标准品类中自带的物模型设定，包含“当前温度”、“当前湿度”和“地理位置”信息。这三条都适合属性信息，其标识符、数据类型、数据定义及该属性支持的操作都可以在这个页面看到。

   标识符是设备端上报设备属性状态的消息中需要使用的标识符，并且只有在设备上报的属性内容符合“数据定义”中的数据取值范围的时候才会被物联网平台记录，否则会被物联网平台认定为非法属性而过滤掉。

   如果在创建产品的时候没有选择标准的品类，则需要在这个地方新增物模型的属性或服务。详情请参考物联网平台中的内容。

   产品及其物模型创建完成后就可以创建这个产品的设备了。

创建云端设备（获取三元组）

   在产品列表页面中，点击“管理设备”，就会进到设备管理页面。

   在“设备”页面点击“添加设备”按钮，如下图所示。

   在“添加设备”页面中设定“deviceName”，这里开发者可以自己填入自己想设定的设备名称，也可以不填任何内容让系统自动生成设备名称，如下图所示。

   设备添加完成后，点击“前往查看”按钮，就可以看到此设备端详细信息了。

   设备信息中有两个信息需要和设备端开发相匹配：

1. 三元组
2. 物模型属性信息

获取设备三元组

   如上图所示，点击“查看”按钮，就可以看到设备的三元组信息，三元组是物联网设备端和物联网云端设备相关联的唯一标识符，在设备端连接云端的时候会使用三元组信息和云端进行鉴权，鉴权通过之后云端会认为设备已激活并上线。

查看设备属性信息

   设备详情信息页中的“物模型数据”标签页中可以看到设备的所有属性信息、设备时间上报情况及设备服务调用情况，如下图所示。待物联网设备按照设备属性对应的标识符上报设备属性的时候，本图片中的“当前温度“，”当前湿度“等属性值就会显示设备最新的属性信息。

创建产品和设备的过程是按照面向对象的思想进行设计的，其中创建产品可以看成是新建一个类，其中的物模型则是类的对象，创建设备则是进行类的实例化。

云端物模型

   在此产品的物模型中新增两个bool类型的属性，命名为"airconditioner"和"humidifier"分别用来控制空调和加湿器。

• 当需要打开空调时，云端将“airconditioner”的属性值设置为True；需要关闭空调时，将其设置为False。
• 当需要打开加湿器时，云端将“humidifier”的属性值设置为True；需要关闭空调时，将其设置为False。

   添加物模型属性的过程下所述：

1. 在产品的“功能定义”标签页中点击"编辑草稿"，如果没有“编辑草稿”的按钮，说明此产品的物模型已经发布，需要点击右上角的“取消发布”按钮才能添加或删除属性。

2. 点击“添加自定义功能”按钮，如下图所示：

3. 添加属性名称、标识符、类型等信息，如下图所示：

• 添加“airconditioner”属性

• 添加“humidifier”属性

   添加完属性之后，点击左下角的“发布上线”按钮 ，根据系统提示进行确认即可，如下图所示：

多设备场景联动设定

   控制逻辑有两种实现方式：

1. 使用物联网平台的规则引擎功能
2. 使用IoT Studio的业务逻辑功能

   本节接下来就开始介绍使用物联网平台的规则引擎来完成此控制逻辑的设定。

   按照下图所示的步骤创建场景联动的规则：

   点击“创建规则”之后，填入场景规则名称，这里我们先创建第一个“温度过高开启空调”的规则。

   规则创建完成后，等待几秒钟系统会自动跳转到规则编辑页面，这里需要配置如下两步完整一整条规则的创建：

1. 设置“触发器”为温湿度监控器的“当前温度"属性高于茶花最适宜生长的温度28度触发此规则的执行，如下图所示

2. 设置“执行动作"为控制设备打开”空调开关“属性

   点击保存之后”温度过高打开空调“的场景联动规则就创建好了。    用相同的方式创建另外三条场景联动规则：

• "温度合适关闭空调"，如下图所示

• "湿度过低打开加湿器“，如下图所示

   创建完这几条规则之后，在”场景联动“页面中点击规则后面的启动按钮，则所有的规则都会运行起来。

设备端开发

开发环境

   在进行下一步之前请确保ESP32开发环境已经搭建完毕。详情请参考esp32开发环境的说明。

创建解决方案

   点击下图中的"快速开始"按键()会弹出HaaS Studio的欢迎页面，请点击“创建项目”按钮。

   在随后弹框中，设定好项目名称（“humiture”）及工作区路径之后，硬件类型选择ESP32，点击“立即创建”，创建一个Python轻应用的解决方案。

   将脚本目录中的所有文件复制后覆盖humiture工程目录下的原有文件。其中main.py脚本的内容如下图所示：

   然后对main.py里边的内容后需要完成以下三处代码修改。

Python脚本的详细说明请参考脚本内嵌的文字版注释

1. 修改路由器名称及密码    修改humiture工程里main.py中wifiSsid和wifiPassword的值为读者实际要连接的路由器的名称及密码（请注意名称和密码都需要放在""符号中间）。

# Wi-Fi SSID和Password设置
wifiSsid = "请填写您的路由器名称"
wifiPassword = "请填写您的路由器密码"

   修改完成之后get_wifi_status函数中的wlan.connect(wifiSsid, wifiPassword)语句就会连接读者自己设定的路由器。

2. 修改设备端三元组

   修改humiture工程里main.py中productKey、deviceName和deviceSecret的值为读者创建的物联网设备的三元组信息，如下图所示：

# 三元组信息
productKey = "产品密钥"
deviceName = "设备名称"
deviceSecret = "设备密钥"

3. 修改设备端上报温湿度信息所用标识符

   humiture工程里main.py中下面的代码实现的是上传温湿度值到云端的功能。其中CurrentTemperature和CurrentHumidity便是温湿度值上报时所用的标识符。

# 上传温度信息和湿度信息到物联网平台
def upload_temperature_and_Humidity():
    global device

    while True:
        data = get_temp_humi()                      # 读取温度信息和湿度信息
        # 生成上报到物联网平台的属性值字串
        prop = ujson.dumps({
            'CurrentTemperature': data[0],
            'CurrentHumidity': data[1]
            })
        print('uploading data: ', prop)

        upload_data = {'params': prop}
        # 上传温度和湿度信息到物联网平台
        device.postProps(upload_data)
        utime.sleep(2)

   确保这两个标识符和物联网产品的物模型中属性标识符是一样的，如下图所示：

   下面是本节添加的重点代码段落讲解：

• 新增两个变量用来控制空调和加湿器对应的GPIO

# 空调和加湿器状态变量
airconditioner = 0
humidifier = 0

• 新增函数处理云端信息并控制GPIO的接口

# 设置props 事件接收函数（当云平台向设备下发属性时）
def on_props(request):
    global airconditioner, humidifier, airconditioner_value, humidifier_value

    # {"airconditioner":1} or {"humidifier":1} or {"airconditioner":1, "humidifier":1}
    payload = ujson.loads(request['params'])
    # print (payload)
    # 获取dict状态字段 注意要验证键存在 否则会抛出异常
    if "airconditioner" in payload.keys():
        airconditioner_value = payload["airconditioner"]
        if (airconditioner_value):
            print("打开空调")
        else:
            print("关闭空调")

    if "humidifier" in payload.keys():
        humidifier_value = payload["humidifier"]
        if (humidifier_value):
            print("打开加湿器")
        else:
            print("关闭加湿器")

    # print(airconditioner_value, humidifier_value)

    airconditioner.write(airconditioner_value) # 控制空调开关
    humidifier.write(humidifier_value)         # 控制加湿器开关

    # 要将更改后的状态同步上报到云平台
    prop = ujson.dumps({
        'airconditioner': airconditioner_value,
        'humidifier': humidifier_value,
    })

    upload_data = {'params': prop}
    # 上报空调和加湿器属性到云端
    device.postProps(upload_data)

运行结果

   推送此脚本到ESP32之后，运行此脚本，ESP32串口会周期性的打印如下日志。其中：

• “物联网平台连接成功” 代表成功连接到物联网平台

• "uploading data:"之后跟着的为设备端向云端发布的温湿度属性信息，其中CurrentTemperature后面的数值为温度值，单位：摄氏度；CurrentHumidity后面数值为相对湿度值。

• 设备端解析到云端送下来的控制指令中包含“{"humidifier":1}”之后会打印"打开加湿器"并点亮绿色LED模拟打开控制加湿器的继电器的动作

• 设备端解析到云端送下来的控制指令包含"{"airconditioner":1}"之后会打印"打开空调"并点亮蓝色LED模拟打开控制空调的继电器的动作

 ==== python file check /data/pyamp/main.py ====
 ==== main.py update time = 691107276 ====
 ==== python execute from /data/pyamp/main.py ====
sht3x inited!
wifi_connected: False
wifi_connected: False
wifi_connected: False
wifi_connected: False
wifi_connected: False
wifi_connected: False
wifi_connected: False
wifi_connected: False
('192.168.0.116', '255.255.255.0', '192.168.0.1', '192.168.0.1')
sleep for 1 s
establish tcp connection with server(host='a158sBmxLet.iot-as-mqtt.cn-shanghai.aliyuncs.com', port=[443])
tcp_connect: can only connect from state CLOSED
success to establish tcp, fd=54
物联网平台连接成功
sleep for 2s
uploading data:  {"CurrentTemperature": 28.30015, "CurrentHumidity": 50.82117}
打开空调
打开加湿器

   开发板实际效果如下：

• 在温度高于阈值时，可以看到日志中出现"打开空调"的字样，伴随着蓝色LED灯亮起

• 在温度低于阈值之后 ，可以看到日志中出现“关闭空调”的字样，伴随着蓝色LED灯熄灭

• 在湿度低于阈值时，可以看到日志中出现"打开加湿器"的字样，伴随着绿色LED灯亮起

• 在湿度高于阈值时，可以看到日志中出现"关闭加湿器"的字样，伴随着绿色LED灯熄灭

物联网平台端设备信息查看

   物联网设备的系统启动成功并连接到物联网平台之后，物联网平台上对应的设备状态会从”未激活状态“变为”上线“，在物模型数据标签页上会显示设备上报到物联网平台的属性值。

   此时如果开发板温度和周围湿度发生变化，物联网平台的物模型数据会更新为设备上报的最新的属性值。

物联网应用开发

   现代花卉养植的过程中越来越多的需要农业专家的参与，但和养花的农户来说，农业专家的数量是很少的。在茶花生长出现问题的时候，怎样让农业专家远程迅速的完成对茶花异常生长状况的诊断是很重要的一个研究议题。本节要介绍的中控大屏就是将茶花当前生产环境的信息通过网页的形式直观的展现出来，一方面方便农户很方便的查看相关信息并判断是否需要人为干预；另一方面在出现问题的时候可以让专家远程快速的对问题进行诊断。

中控大屏目标

   本节课程主要目标是设计一个总控大屏的web应用，能实时的查看如下信息：

1. 过去3小时的温湿度实时信息
2. 空调及加湿器状态实时状态显示
3. 手动控制空调或加湿器的开关状态

茶花生长环境监控系统

   下图是一个典型的物联网应用程序开发的流程图，接下来本节就按照这个流程介绍如何花卉养植系统中控大屏的web应用程序的开发。

新建“普通项目”

   打开IoT Studio官网，在项目管理中创建一个空白项目，如下图所示，将此项目命名为“茶花养植系统”。

新建“Web应用”

   新建“普通项目”之后，在新项目的首页新建一个Web应用，命名为“茶花生长环境实时监控”。

   Web应用创建成功后会进入到应用界面设计页面。

   点击上图红框中的“组件”按钮图标，就可以看到可用的组件列表。各组件的说明请参考IoT Studio组件说明。

页面设计

   这里我们用到3个组件:

• 实时曲线 用于显示温湿度的历史变化曲线及实时数据
• 开关 显示和控制空调和加湿器的当前状态
• 图片 空调或加湿器的示意图

   将三个组件拖到中间的画布区，适当调整组件布局。然后选中图片组件，点击右边的“上传图片”按钮，分别上传空调和加湿器的图片，如下图所示。

关联产品和设备

   此时回到”茶花养植系统“项目的主页，对产品和设备进行关联，如下图所示：

   关联产品的过程如下：

   关联设备的过程如下：

关联数据源

   关联数据源分为如下3个步骤，每个步骤的截图如下：

• 关联产品
• 关联设备
• 关联属性

   具体操作步骤如下：

1. 选中”开关“组件，点击右侧的“配置数据源”。

2. 选择目标产品

3. 选择目标设备

4. 选择“空调开关”属性

   选择好产品、设备和属性之后，可以看到湿度计表盘上面的湿度值已经已经更新为物联网平台设备属性中最新的湿度值。

   同样的方式为另一个”开关“组件选择相同设备的“加湿器”属性。 接下来需要为”实时曲线“组件设定数据源。同样点击该组件后，点击右边的配置数据源。因为本场景中的温湿度测量和空调/加湿器控制都是通过一个物联网设备完成的，所以本页中要选择”单设备多属性“。然后选择好本场景创建的产品，如下图所示。

   选择相同的设备，如下图所示。

   本场景显示的是茶花生长环境的温度信息和湿度信息，所以”数据项“中要选择这两项属性。

   最后选择要显示的实时温湿度数据的时间长度，这里选择3小时，如下图所示。

发布上线

   在发布之前可以点击上图的“预览”查看应用的实际运行效果。实际运行效果如下图所示：

   这样我们就完成了一个花卉养殖系统从设备端温湿度测量，设备控制、物联网云平台开发及物联网应用开发全链路的开发。如果想要学习花卉养植系统更详细的操作步骤，请参考“花卉养植系统详解”中的说明。