摘要：本文讲解如何利用华为云IOT物联网平台实践搭建一个智慧农业智慧大脑。
本文分享自华为云社区《物联网应用开发实践案例-智慧农业【玩转华为云】》，作者： DS小龙哥。
1. 设计需求、硬件环境介绍
1.1 项目背景
近几年，物联网、智能家居、AI人工智能技术发送非常迅速。在物联网技术的支撑下，如今农业逐渐走向现代化，自动化、现在智能化的农业生产成为了主流。告别“刀耕火种”的传统农业后，现代农业也正在向智慧型转变，当前智慧农业模式已经深入到农业生产的各个环节，灌溉、施肥、植保等细分领域都将与物联网、信息技术等先进科技相结合，效率、效果也将得到大大提高。
要知道，所谓的“智慧农业”就是充分应用现代信息技术成果，集成应用计算机技术与网络技术、物联网技术、无线通信技术以及专家智慧与知识等，实现农业可视化远程诊断、远程控制、灾变预警等智能管理。那么融入物联网的智慧农业的有以下几个优点：
1、低成本化
众所周知，目前想要购买一套全面的智慧农业设备的成本都较高，这是普通农户难以承受的,因此，想要实现全面智慧农业,那么低成本的智慧农业设备将成为智慧农业趋势之一。
2、操作简单化 智慧农业的根本是服务于农业、服务于农户，所以想要做到让农户更快地与智慧农业接轨就必须要把系统做得易操作、易学。要知道，当前我国农民普遍文化程度较低，只有将操作简单化才能够让每个农民都能熟练操作。
智慧农业也是一个大范围，比如： 智慧鱼塘、智慧大棚、智慧园林、城市绿化、智能果园等等都属于智慧农业的范围。
有了智能设备的加持：可以实现自动浇水灌溉、实时检测土壤养分、水分、环境温度、自动补光等一系列联动操作。
本篇文章就利用华为云IOT物联网平台实践搭建一个智慧农业智慧大脑，设备平台采用小熊开发板，搭载的CPU是意法半导体的STM32L431芯片，这是意法半导体推出的低功耗芯片；配合外部的一些专业传感器，能够获取空气中的温湿度数据，光照度数据等，根据种植区的空气温湿度数据，判断是否进行灌溉。
1.2 实现功能
本项目是利用意法半导体的STM32L431+ESP8266 WIFI ，配合华为云物联网平台服务器，组建一个智慧农业控制系统，结合外部传感器采集的数据，并利用这些数据判断是否进行灌溉，补光等信息提示。
考虑到以学习、实践为目的，当前项目采用了ESP8266无线WIFI网卡作为联网设备，ESP8266价钱便宜，支持串口编程，有标准的一套AT资料，资料多，作为学习而言，非常适合。可以通过对ESP8266的编程实验，了解TCP、MQTT网络编程相关知识点。
当前项目主要分为六个功能模块，分别是：基础系统模块、温度采集模块、湿度采集模块、光照采集模块、无线传感器网络模块、OLED显示屏模块。
（1）基础系统模块：进行各个数据的接收与转发，控制扫水作业是否进行，浇水作业是采用板载的电机模拟
（2）温度采集模块：采集监测区域的温度数据，传输到微控制器
（3）湿度采集模块：采集监测区域的湿度数据，传输到微控制器
（4）光照采集模块：采集监测区域的光照数据，传输到微控制器
（5）无线传感器网络模块：数据上传至云平台，数据下发交互等
（6）LCD显示屏模块：实时显示所监测到的各项数据
小熊开发板的扩展板上自带了光敏传感器、温湿度传感器、直流电机模块，可以很方便的实现上面的这些功能需求。
本项目设备的源代码里，连接华为云的MQTT协议是按照MQTT的官方中文手册编写的，不依赖任何外部SDK，不依赖ESP8266设备，只要能联网的设备都可以连接华为云IOT，非常适合移植到其他单片机平台；不管是采用51，STM32F1系列，都可以直接参考代码移植。
华为云物联网平台提供了API接口，可以通过API开发配套的上位机，方便实现数据查看，手动灌溉等操作。
提供的API除了可以查询设备属性信息之外，还可以创建产品、设备、对开发上位机来讲非常方便，可以开发出从底层设备到云端服务器、再到应用APP软件，完成3层数据交互。
下面是开发的上位机APP运行效果。
当前文章主要完成3个任务的实践：
（1）云端产品的创建、设备的创建
（2）设备上云，完成服务器登录、数据上传
（3）手机APP、电脑上位机软件的开发，可以通过云端API接口与设备、服务器之前通讯
1.3 设备实物图
目前联网的设备采用的ESP8266（手上没有现成的NBIOT模块，暂时使用ESP8266代替，核心原理是一样的），正常项目里会使用NBIOT模块联网作为数据传输源。
小熊开发板的设备相关实物图如下:
2. 创建IOT服务器端产品
需要先创建产品、在产品下再创建设备。产品是一个大框架，产品下的设备可以有很多，在应用层，可以通过华为云平台提供的API创建设备，删除设备，查询设备属性，在做产品时，软件端可以做一个设备注册的引导界面，完成产品下的设备注册，再将数据传递给设备端，这个过程叫“配网“，具体逻辑需要配合设备端完成。最终完成自动化设备创建，注册，上线等操作。
下面先介绍如何手动创建产品，创建设备，了解创建产品创建设备的过程中需要填充什么参数，理解之后，再使用API时才更加理解参数含义。
2.1 创建产品
直接打开物联网产品页面: https://www.huaweicloud.com/product/iothub.html
打开产品页面，选择右上角创建产品。
根据自己情况填写信息。就是填写自己产品的一些参数信息。
创建成功后打开产品详情页面，拉到最下面，点击创建自定义模型文件。
这里创建模型文件主要就是为了MQTT客户端能够正确的上传传感器数据上来，每个传感器设置一个属性，这个属性就是表示了传感器的数据值类型。
比如: 先添加一个电机，这个电机就是浇水电机，能上报开关状态，云端也能下发命令控制电机，所以需要添加属性和下发的命令。
添加属性:
添加命令: 因为电机需要云端远程控制。
接下来就创建温度、湿度、光照度传感器的属性，这些传感器只是向云端上传数据，不需要下发指令控制，选择只读就可以了，电机要先实现远程浇灌控制，属性就选择读写。
创建完毕效果，一共有4个属性，电机、温度、湿度、光强度:
2.2 创建设备
选择设备页面，注册设备。
创建后保持设备密匙等信息，接下来登录服务器时，生成MQTT账号密匙需要用到这些参数。
当前创建的设备信息如下:
2.3 生成MQTT登录账号信息
官微提供的在线小工具: https://iot-tool.obs-website.cn-north-4.myhuaweicloud.com/
按照提示填入数据，生成，非常方便。
当前生成的信息如下:
3. 使用MQTT客户端模拟测试
为了验证服务器配置是否OK，先使用MQTT客户端软件进行连接测试。
3.1 华为云IOT服务器地址与端口
3.2 订阅主题
在产品页面，可以看到主题管理页面，能看到当前设备可以订阅的主题有哪些。
一般订阅下发的数据:
3.3 上报主题数据
官方文档介绍: https://support.huaweicloud.com/devg-iothub/iot_01_2127.html
服务ID，属性ID在产品页面查看，2.1小节创建产品里就讲了这个属性的作用。
每次可以单个属性上报，也可以一起上报。
3.4 登录服务器
按照软件提示，填入相关数据即可。
如需要也需要使用和我一样的同款软件，打开百度搜索MQTT客户端_v2.4(协议3.1.1).exe 即可找到下载地址。
发送数据后查看云端，已经登录成功,数据已经上传成功。
3.5 下发命令
电机设备支持读写，支持下发命令，在设备页面测试。
点击确定之后，参看MQTT客户端软件，已经收到了下发的数据。
4. 设备端上华为云IOT
4.1 安装keil软件
MCU采用的STM32芯片，设备端代码编写开发就采用的keil5。
keil5安装包下载地址: http://www.myir-tech.com/download.asp
安装keil时，软件要放在英文目录下，电脑的用户名必须是英文，否则会出现一些奇怪问题。
安装过程中，根据提示下一步下一步点击即可。
4.2 编写代码
工程代码:
工程代码较多，这里就贴出main.c全部代码:
5. 上位机软件开发
上位机与设备之间通信，需要通过服务器完成，服务器提供了对应的API接口，所以对于上位机而言通信主要是对HTTP请求进行处理，返回的数据进行解析等操作。
当前的软件采用是采用QT设计的，实现了产品注册、设备注册、获取在线设备，获取设备属性，远程指令发送等主要功能。
访问华为云的接口都需要填一个X-Auth-Token参数，这个参数获取需要IAM账号，下面第一步就先介绍，如何创建IAM账号，如何获取X-Auth-Token参数。
5.1 创建IAM账户
创建一个IAM账户，方便接下来使用API接口访问华为云服务时，生成token登录密匙。
地址: https://console.huaweicloud.com/iam/?region=cn-north-4#/iam/users
账户创建好之后，代码里就可以编写一个获取Token的函数。
5.2 查询设备列表
帮助文档地址: https://support.huaweicloud.com/api-iothub/iot_06_v5_0048.html
官方提供了API接口，可以直接获取产品下面的所有设备详细信息返回。
关于请求参数，返回结果的字段含义，在帮助文档里有详细介绍。
接口的在线调试地址：https://apiexplorer.developer.huaweicloud.com/apiexplorer/debug?product=IoTDA&api=ListDevices
返回的结果：
上面的返回结果里通过JSON数组保存了设备信息，每一个设备就是一个独立的对象，上面的数据里返回了两个设备的信息，说明产品的目录下创建了两个设备。
应用层编写代码完成设备列表获取:
服务器返回的结果解析:
5.3 查询设备属性
（1）应用端查询设备属性的请求
帮助文档地址: https://support.huaweicloud.com/api-iothub/iot_06_v5_0034.html
（2）在线调试地址
接口的在线调试地址: https://apiexplorer.developer.huaweicloud.com/apiexplorer/debug?product=IoTDA&api=ListProperties
（3）设备端响应的数据格式
帮助文档: https://support.huaweicloud.com/api-iothub/iot_06_v5_3011.html
（4）使用总结
上位机APP向设备端请求查询设备属性时，设备端会收到如下的消息:
设备端需要解析这个字符串，得到里面的request_id=5f359b5c-542f-460e-9f51-85e82150ff4a 值。在向服务器回应时，要带上这个请求ID。
（5）应用端获取设备属性
（6）应用端解析数据
5.4 上位机开发环境搭建
上位机软件是采用QT开发的，Qt是一个1991年由QtCompany开发的跨平台C++图形用户界面应用程序开发框架。它既可以开发GUI程序，也可用于开发非GUI程序，比如控制台工具和服务器。QT在发布 Qt 4.6 的同时，作为 Qt 开发跨平台 IDE 的Qt Creator也发布了更新版本。Qt Creator是一个用于Qt开发的轻量级跨平台集成开发环境。Qt Creator可带来两大关键益处：提供首个专为支持跨平台开发而设计的集成开发环境 (IDE)，并确保首次接触Qt框架的开发人员能迅速上手和操作。即使不开发Qt应用程序，Qt Creator也是一个简单易用且功能强大的IDE。
目前QT在嵌入式领域、桌面端都用的非常多，开发桌面，嵌入式的上位机还是非常方便。 嵌入式领域包括： 车机主机、嵌入式Linux设备等。
QT官网: https://resources.qt.io/cn
QT5.12.6安装包下载地址: https://download.qt.io/archive/qt/5.12/5.12.6/
QT学习专栏: https://blog.csdn.net/xiaolong1126626497/category_11400392.html
QT环境搭建文章：https://xiaolong.blog.csdn.net/article/details/120654599
6. 总结
整个项目的实现主要分为两个大部分：1. 设备上云 2. 应用侧的软件开发
（1）设备上云： 目前通过STM32、ESP8266已经完了华为云物联网云平台的连接，ESP8266上云的过程主要是MQTT协议的理解，目前采用的ESP8266没有内置MQTT协议相关的AT指令，需要自己实现MQTT协议，这个过程稍微麻烦一点，需要安装官网的MQTT协议手册拼接结构完成协议构造。对于设备端而言，只要是通信采用标准的MQTT协议，不管连接哪一个物联网云平台，过程是没有多大区别的。
（2）应用层软件开发： 应用侧软件开发主要是方便远程管理设备，目前华为云物联网平台没有提供在线web设计功能、没有提供公版的APP；所以，在设备上云之后，想要方便的对设备的属性进行查看，管理，都需要自己开发上位机才行。
