简介本资源是一套基于STM32F103RCT6与ESP8266的智能浇花系统完整工程面向嵌入式初学者、物联网实践者及农业自动化爱好者解决土壤湿度实时监测、云端数据上传与自动灌溉控制的核心问题。项目融合传感器采集、UART通信、Wi-Fi联网、OneNet云平台对接及继电器驱动等关键技术适用于家庭园艺、阳台种植或教学实验等场景。压缩包含173个文件以52个.h头文件、24个.c源码、25个.o目标文件及24个.d依赖文件为主涵盖HAL库驱动如stm32f1xx_hal_adc.c、uart.c、tim.c、ESP8266 AT指令交互逻辑、OneNet数据上报协议实现及继电器控制模块另有.axf、.hex、.uvprojx等编译与工程文件便于Keil平台直接编译调试。目前已有1133人学习下载提供可运行的全栈代码、清晰的模块划分与典型IoT软硬协同实践路径助读者快速掌握从传感器读取到云平台联动的完整开发流程。1. 项目概述与核心价值最近在折腾一个智能灌溉的小项目核心目标是把温湿度、土壤湿度这些环境数据采集上来通过ESP8266传到OneNET云平台然后由一块STM32F103RCT6做主控判断土壤湿度是否超标一旦超标就驱动继电器控制水泵出水。这听起来像是一个典型的物联网自动控制的应用但实际做下来你会发现从传感器选型、数据链路搭建到逻辑控制每一步都有不少细节需要抠。这个项目非常适合想从单片机玩到物联网再结合一点自动控制的朋友它把数据采集、无线传输、云平台展示和本地执行联动都串起来了算是一个小而全的练手好案例。我之所以选择这个组合主要是考虑成本和生态。ESP8266作为Wi-Fi模块已经非常成熟资料多AT指令或者直接编程都方便。OneNET作为国内比较稳定的物联网平台免费额度对个人项目足够友好可视化组件也能快速搭建一个监控面板。STM32F103RCT6则是经典的“国民MCU”性能足够处理逻辑判断和驱动继电器价格也便宜。土壤湿度传感器和温湿度传感器更是几块钱就能搞定。整个系统的逻辑很直观传感器数据是输入云平台是远程监控和“大脑”可以设置阈值STM32是本地“小脑”负责最终执行。当网络断开时本地逻辑依然能保证基本的自动灌溉功能这种“云边协同”的思路在实际应用中很实用。2. 系统架构设计与硬件选型解析2.1 整体系统框架拆解整个系统可以清晰地划分为感知层、传输层、平台层和执行层。感知层负责采集物理世界的信号也就是我们用的DHT11温湿度传感器和土壤湿度传感器。传输层的核心是ESP8266它负责将感知层的数据通过Wi-Fi网络上传到互联网。平台层我选择了OneNET它充当了数据中转站、存储中心和远程监控面板的角色。执行层则是STM32F103RCT6加上继电器模块和水泵负责接收指令或根据本地逻辑进行动作。这里有一个关键的数据流向设计。最初我考虑过让ESP8266直接连接传感器并做逻辑判断但这样ESP8266的负担较重且GPIO和ADC资源有限。更合理的架构是让STM32作为主控它连接所有传感器并读取数据然后通过串口将打包好的数据发送给ESP8266。ESP8266只专心做一件事通过Wi-Fi连接OneNET并上传数据。同时STM32也会通过串口从ESP8266接收来自OneNET的指令如下发的水泵开关命令或者STM32自己根据本地预设的土壤湿度阈值进行判断直接控制继电器。这种架构分工明确STM32强大的处理能力和丰富外设得以利用ESP8266也稳定在它最擅长的网络通信上。2.2 核心硬件组件选型与接口定义主控制器STM32F103RCT6选择这款芯片是因为它资源足够。它有3个USART我可以用一个与ESP8266通信另一个预留调试打印。多达51个GPIO连接传感器、继电器绰绰有余。并且它有2个ADC可以方便地读取土壤湿度传感器这类模拟输出设备。成本上核心板也就二十块钱左右性价比极高。Wi-Fi模块ESP-01S (ESP8266)这是最常用的ESP8266模组之一体积小直接使用AT指令固件即可无需自己开发底层Wi-Fi驱动大大降低了难度。它通过串口与STM32通信供电是3.3V需要注意与STM32的串口电平匹配。传感器部分温湿度传感器DHT11数字接口单总线通信直接输出数字化的温湿度值避免了STM32内部ADC的误差。虽然精度一般湿度±5%温度±2℃但对于环境监控完全足够。它只需要一个GPIO引脚进行通信。土壤湿度传感器模拟输出款我选用的是最常见的模拟输出传感器。它工作时两个探针之间的电阻会随土壤湿度变化模块内部电路将其转换为0-3.3V的模拟电压输出。STM32的ADC读取这个电压值再通过校准转化为湿度百分比。这里要注意这种传感器长期插在土里容易电解腐蚀最好间歇供电不要一直通电。执行机构继电器模块选用常用的5V驱动、低电平触发的单路继电器模块。STM32的GPIO输出低电平时继电器吸合高电平时断开。模块自带光耦隔离能保护MCU免受水泵等感性负载的干扰。水泵根据灌溉面积选择合适流量的直流潜水泵或微型水泵。关键点在于水泵功率不能超过继电器触点的负载能力。常见的小继电器模块触点容量是10A/250VAC或10A/30VDC。一个12V/5W的小水泵电流大约0.42A远在安全范围内。电源设计这是一个容易忽视但至关重要的部分。系统需要多种电压ESP8266需要3.3VSTM32核心板通常有LDO可从5V转3.3V继电器模块和某些水泵需要5V或12V。建议采用一个12V/2A的直流电源适配器作为总输入。然后通过DC-DC降压模块得到稳定的5V给STM32核心板、继电器线圈供电。STM32核心板上的LDO再从5V生成3.3V给自身和ESP8266、传感器供电。水泵则根据其额定电压选择由12V直接驱动或通过5V驱动。务必确保电源功率充足特别是水泵启动瞬间电流较大。3. 核心电路连接与通信协议制定3.1 硬件接线详解与注意事项接线是实打实的第一步接错了轻则不工作重则烧芯片。下面我详细列出STM32F103RCT6最小系统板与各模块的连接方式并解释为什么这么接。STM32与ESP-01S的连接这是系统的通信主干。我们使用串口2 (USART2)。ESP-01S TX-STM32 PA3 (USART2_RX)ESP-01S RX-STM32 PA2 (USART2_TX)ESP-01S VCC-3.3V(必须确保是稳定的3.3V最好单独一路LDO)ESP-01S GND-GNDESP-01S CH_PD (EN)-3.3V(拉高使能)ESP-01S GPIO0- 悬空或接高电平运行模式。如果需要烧录固件则需在启动时拉低。注意ESP-01S的RX引脚耐受5V但TX输出是3.3V电平。STM32F103的IO口大部分是5V容忍的所以直接连接问题不大。但为了绝对安全或者如果你的STM32是3.3V供电的版本建议在ESP-01S的TX线和STM32的RX之间加一个简单的电平转换电路如两个电阻分压或者直接使用电平转换模块。STM32与DHT11的连接单总线设备接一个GPIO即可例如PA1。DHT11 VCC-3.3VDHT11 GND-GNDDHT11 DATA-STM32 PA1同时需要在该引脚上加一个4.7K-10K的上拉电阻到3.3V。STM32与土壤湿度传感器的连接模拟传感器接ADC引脚。传感器 VCC-3.3V(建议通过STM32的GPIO控制其电源实现间歇供电)传感器 GND-GND传感器 AO (模拟输出)-STM32 PA0 (ADC1_IN0)或其他ADC通道。STM32与继电器模块的连接继电器模块 VCC-5V继电器模块 GND-GND继电器模块 IN (信号线)-STM32 PB0(任意一个GPIO均可)。继电器与水泵的连接继电器模块 COM (公共端)-电源正极 (如12V)继电器模块 NO (常开端)-水泵正极水泵负极-电源负极 (GND)这样当STM32给PB0输出低电平时继电器吸合COM与NO接通水泵得电工作。3.2 串口通信协议与数据包设计STM32和ESP8266之间需要通过串口高效、可靠地交换数据。不能只是随意地发送字符串需要设计一个简单的协议。我采用“帧头命令字数据长度数据内容校验和帧尾”的结构。例如定义STM32发送给ESP8266的数据帧格式如下[0xAA] [0x55] [CMD] [LEN] [DATA...] [SUM] [0x0D] [0x0A]0xAA, 0x55: 固定的帧头用于在数据流中识别一帧的开始。CMD: 命令字。例如0x01代表上传传感器数据0x02代表状态查询。LEN: 后续数据域的长度。DATA: 具体的数据。对于传感器数据我可以将其打包为[温度高8位][温度低8位][湿度高8位][湿度低8位][土壤湿度高8位][土壤湿度低8位]。这样将float或int类型的数据转为两个字节传输。SUM: 从CMD到DATA最后一个字节的累加和校验或异或校验用于验证数据在传输过程中是否出错。0x0D, 0x0A(\r\n): 帧尾方便某些串口助手的观察。同样ESP8266收到OneNET下发的指令后也按照类似的格式打包发给STM32。例如命令字0xA1代表远程控制水泵数据域里用一个字节表示开关状态0x00关0x01开。在STM32的程序中需要编写一个串口中断服务函数进行数据包的接收、解析和校验。只有校验通过的数据包才会被处理这能极大提高通信的可靠性。4. 嵌入式端软件实现与逻辑控制4.1 STM32程序设计数据采集与本地决策STM32的程序主要围绕几个外设展开ADC读取土壤湿度、GPIO模拟时序读取DHT11、定时器进行周期采集、USART与ESP8266通信、以及主循环中的状态判断。DHT11驱动DHT11的时序要求比较严格。它需要MCU先拉低总线至少18ms启动信号然后拉高并等待传感器响应。传感器会拉低80us再拉高80us之后开始传输40位数据16位湿度16位温度8位校验和。每一位数据都以50us的低电平开始高电平的持续时间决定是026-28us还是170us。编写代码时必须禁用中断用微秒级延时函数来精确判断电平持续时间。校验和是前四个字节相加必须与收到的校验和字节相等数据才有效。ADC读取土壤湿度配置ADC为单次转换模式读取连接到土壤湿度传感器AO引脚的通道。由于传感器输出可能受供电电压、土壤成分影响直接读到的ADC值比如0-4095需要校准。我的做法是先将传感器完全干燥时读到的值记为dry_val再将其完全浸入水中时读到的值记为wet_val。那么当前的湿度百分比可以用这个公式估算humidity_percent (float)(wet_val - current_val) / (wet_val - dry_val) * 100.0。这个百分比值可以打包进数据帧。本地控制逻辑这是项目的核心自动功能。在主循环中我会定期比如每10秒检查最新的土壤湿度百分比。我设置一个阈值比如THRESHOLD_LOW 30.0表示土壤湿度低于30%需要浇水。当humidity_percent THRESHOLD_LOW时STM32会控制继电器打开水泵。同时为了防止过度浇水我还会引入一个THRESHOLD_HIGH 60.0和一个状态机。水泵开启后持续监测湿度一旦humidity_percent THRESHOLD_HIGH就关闭水泵。此外必须加入防抖延时比如水泵每次开启后至少运行10秒避免在阈值附近频繁启停。4.2 ESP8266 AT指令流程与网络配置我使用安信可官方AT固件让ESP8266工作在Station模式连接家庭Wi-Fi。STM32通过串口发送AT指令来控制它。流程如下上电初始化STM32发送AT期待返回OK确认模块就绪。设置模式ATCWMODE1设置为Station模式。连接Wi-FiATCWJAPSSID,password。这里有个坑如果密码包含特殊字符需要正确处理。连接成功会返回WIFI CONNECTED和WIFI GOT IP。连接OneNETOneNET支持多种协议我选择最简单的HTTP协议进行数据上报。首先需要建立TCP连接ATCIPSTARTTCP,183.230.40.33,80。这是OneNET的HTTP API服务器地址和端口。上报数据连接成功后就可以构造HTTP POST请求了。STM32需要将传感器数据按照OneNET要求的格式组织成一个JSON字符串然后通过AT指令发送。例如ATCIPSEND长度 POST /devices/你的设备ID/datapoints?type3 HTTP/1.1 api-key: 你的API-KEY Host: api.heclouds.com Content-Length: JSON数据长度 {datastreams:[{id:temp,datapoints:[{value:25}]},{id:humi,datapoints:[{value:60}]},{id:soil,datapoints:[{value:45}]}]}发送完数据后ESP8266会收到服务器的响应如HTTP/1.1 200 OK表示上传成功。这个过程需要STM32有较好的字符串处理能力来拼接AT指令和JSON数据。务必注意每条AT指令发送后要等待并解析ESP8266返回的响应根据响应决定下一步操作实现一个简单的状态机这样才能保证网络通信的健壮性。5. OneNET云平台配置与数据可视化5.1 设备创建与数据流定义首先需要在OneNET官网注册并登录进入开发者中心。在“产品”里创建一个新产品联网方式选择“Wi-Fi”数据协议选择“HTTP”。创建成功后记下产品ID和API Key。然后在这个产品下“添加设备”填写设备名称和鉴权信息可以简单设为设备SN这样就得到了一个设备ID。设备ID、产品ID和API Key是设备接入的三个关键信息。接下来定义数据流。数据流就像是一个数据标签。在这个项目中我们需要创建三个数据流temp温度、humi湿度、soil土壤湿度。OneNET支持动态创建也就是说如果你上报的数据里包含了一个新的数据流ID平台会自动创建它但提前定义好可以让可视化编辑时更方便选择。5.2 数据可视化面板与触发器设置OneNET的“应用管理”或“可视化”工具可以轻松创建监控面板。我们可以添加三个“数值显示”组件分别关联temp、humi、soil这三个数据流。再添加一个“开关”组件关联一个用于控制水泵的数据流比如pump_switch。这样在面板上就能实时看到环境数据并能手动点击开关远程控制水泵。更强大的功能是“触发器”。我们可以设置一个规则当soil数据流的值低于30时自动向设备下发一条指令内容可以是打开水泵。这个下发的指令就是通过HTTP POST发送到OneNET的指令下发API设备ESP8266需要定期向这个API发起查询GET请求来获取指令这就是“命令下发”的流程。不过在我们的架构里本地STM32已经做了自动控制云平台触发器更多是作为一个备份的远程干预手段或者用于发送报警通知比如通过邮件或短信插件当土壤湿度极低时提醒用户。6. 系统联调、问题排查与优化心得6.1 常见问题与诊断方法在实际焊接和调试中我遇到了不少问题这里总结一下ESP8266无法连接Wi-Fi现象一直返回ATCWJAP失败。排查首先用USB转TTL模块单独连接ESP-01S到电脑用串口助手测试排除硬件连接问题。检查SSID和密码是否正确特别是大小写和特殊字符。尝试将路由器信道固定在1-11避免12、13信道某些固件不支持。靠近路由器测试排除信号问题。ESP8266连接OneNET失败现象ATCIPSTART失败或很快断开。排查检查IP地址和端口是否正确。检查设备ID、API Key是否填写正确。确认OneNET产品是否开启了“设备接入开关”。用电脑ping一下api.heclouds.com看网络是否通畅。数据上报成功但平台不显示现象HTTP返回200但OneNET设备数据流里没有更新。排查这是最常遇到的坑仔细检查HTTP POST请求的格式特别是请求头Headers和JSON数据体。必须严格按照OneNET的API文档来。常见的错误有api-key写错了位置或名称Content-Length计算错误JSON格式不对缺少括号或引号。强烈建议先用Postman或curl工具在电脑上模拟发送一次成功后再移植到代码里。土壤湿度读数不准或跳动大现象ADC值不稳定换算的百分比不合理。排查首先给模拟传感器供电的3.3V必须稳定可以在VCC和GND之间加一个10uF的电解电容滤波。其次ADC采样时软件上可以做多次采样取平均。最根本的是土壤湿度传感器本身精度有限且受土壤密度、成分影响大它更适合做趋势判断而非精确计量。可以考虑做更精细的校准在不同湿度土壤中测量并记录ADC值建立查找表。继电器频繁动作或水泵不工作现象在阈值附近水泵频繁启停或者继电器有响声但水泵不转。排查频繁启停是因为没有加入“回差”控制和最小运行时间。在代码里应该设置THRESHOLD_HIGH比THRESHOLD_LOW高出一个区间如20%并且设置水泵一旦开启至少持续运行30秒再判断是否停止。水泵不转先检查继电器是否真的吸合听声音看指示灯再用万用表测量水泵两端是否有电压。可能是电源功率不足水泵启动电流大导致电压被拉低继电器断开。6.2 稳定性优化与进阶思路项目基本跑通后还可以从以下几个方面优化通信可靠性增强在STM32与ESP8266的通信协议中加入超时重发和应答机制。STM32发送一帧数据后启动定时器等待ESP8266返回一个“已收到”的ACK帧。如果超时未收到则重发重发超过一定次数后进入错误处理流程。低功耗设计如果设备是电池供电功耗至关重要。可以让STM32大部分时间处于休眠模式定时唤醒采集数据并上传。DHT11和土壤湿度传感器在非采集时段断电。ESP8266在上传完成后进入深度睡眠模式。本地数据缓存在网络断开时STM32可以将采集到的数据暂时存储在内部的Flash或外接的EEPROM中。等网络恢复后再将积压的数据一次性上报到云端避免数据丢失。OTA远程升级利用ESP8266的OTA功能或者通过OneNET下发升级指令引导STM32从串口接收新的固件并写入Flash实现设备的远程程序更新这对于部署在户外的设备非常有用。多传感器与执行器扩展STM32的资源和GPIO还有富余完全可以增加更多传感器如光照强度传感器、雨水检测传感器让灌溉逻辑更智能例如下雨天不浇水。也可以增加多个继电器控制不同的水泵或电磁阀实现分区域灌溉。这个项目从硬件焊接到软件调试再到云端配置完整地走通了一个物联网应用闭环。过程中遇到的每一个问题都是对电路知识、嵌入式编程和网络协议理解的加深。当你最终在手机OneNET App上看到实时变化的温湿度曲线并远程控制水泵浇灌了阳台上的绿植时那种成就感是单纯的代码练习无法比拟的。它让你真切地感受到代码是如何作用于物理世界解决实际问题的。本文还有配套的精品资源点击获取 基于STM32与ESP8266的智能灌溉系统：物联网云边协同实战
简介本资源是一套基于STM32F103RCT6与ESP8266的智能浇花系统完整工程面向嵌入式初学者、物联网实践者及农业自动化爱好者解决土壤湿度实时监测、云端数据上传与自动灌溉控制的核心问题。项目融合传感器采集、UART通信、Wi-Fi联网、OneNet云平台对接及继电器驱动等关键技术适用于家庭园艺、阳台种植或教学实验等场景。压缩包含173个文件以52个.h头文件、24个.c源码、25个.o目标文件及24个.d依赖文件为主涵盖HAL库驱动如stm32f1xx_hal_adc.c、uart.c、tim.c、ESP8266 AT指令交互逻辑、OneNet数据上报协议实现及继电器控制模块另有.axf、.hex、.uvprojx等编译与工程文件便于Keil平台直接编译调试。目前已有1133人学习下载提供可运行的全栈代码、清晰的模块划分与典型IoT软硬协同实践路径助读者快速掌握从传感器读取到云平台联动的完整开发流程。1. 项目概述与核心价值最近在折腾一个智能灌溉的小项目核心目标是把温湿度、土壤湿度这些环境数据采集上来通过ESP8266传到OneNET云平台然后由一块STM32F103RCT6做主控判断土壤湿度是否超标一旦超标就驱动继电器控制水泵出水。这听起来像是一个典型的物联网自动控制的应用但实际做下来你会发现从传感器选型、数据链路搭建到逻辑控制每一步都有不少细节需要抠。这个项目非常适合想从单片机玩到物联网再结合一点自动控制的朋友它把数据采集、无线传输、云平台展示和本地执行联动都串起来了算是一个小而全的练手好案例。我之所以选择这个组合主要是考虑成本和生态。ESP8266作为Wi-Fi模块已经非常成熟资料多AT指令或者直接编程都方便。OneNET作为国内比较稳定的物联网平台免费额度对个人项目足够友好可视化组件也能快速搭建一个监控面板。STM32F103RCT6则是经典的“国民MCU”性能足够处理逻辑判断和驱动继电器价格也便宜。土壤湿度传感器和温湿度传感器更是几块钱就能搞定。整个系统的逻辑很直观传感器数据是输入云平台是远程监控和“大脑”可以设置阈值STM32是本地“小脑”负责最终执行。当网络断开时本地逻辑依然能保证基本的自动灌溉功能这种“云边协同”的思路在实际应用中很实用。2. 系统架构设计与硬件选型解析2.1 整体系统框架拆解整个系统可以清晰地划分为感知层、传输层、平台层和执行层。感知层负责采集物理世界的信号也就是我们用的DHT11温湿度传感器和土壤湿度传感器。传输层的核心是ESP8266它负责将感知层的数据通过Wi-Fi网络上传到互联网。平台层我选择了OneNET它充当了数据中转站、存储中心和远程监控面板的角色。执行层则是STM32F103RCT6加上继电器模块和水泵负责接收指令或根据本地逻辑进行动作。这里有一个关键的数据流向设计。最初我考虑过让ESP8266直接连接传感器并做逻辑判断但这样ESP8266的负担较重且GPIO和ADC资源有限。更合理的架构是让STM32作为主控它连接所有传感器并读取数据然后通过串口将打包好的数据发送给ESP8266。ESP8266只专心做一件事通过Wi-Fi连接OneNET并上传数据。同时STM32也会通过串口从ESP8266接收来自OneNET的指令如下发的水泵开关命令或者STM32自己根据本地预设的土壤湿度阈值进行判断直接控制继电器。这种架构分工明确STM32强大的处理能力和丰富外设得以利用ESP8266也稳定在它最擅长的网络通信上。2.2 核心硬件组件选型与接口定义主控制器STM32F103RCT6选择这款芯片是因为它资源足够。它有3个USART我可以用一个与ESP8266通信另一个预留调试打印。多达51个GPIO连接传感器、继电器绰绰有余。并且它有2个ADC可以方便地读取土壤湿度传感器这类模拟输出设备。成本上核心板也就二十块钱左右性价比极高。Wi-Fi模块ESP-01S (ESP8266)这是最常用的ESP8266模组之一体积小直接使用AT指令固件即可无需自己开发底层Wi-Fi驱动大大降低了难度。它通过串口与STM32通信供电是3.3V需要注意与STM32的串口电平匹配。传感器部分温湿度传感器DHT11数字接口单总线通信直接输出数字化的温湿度值避免了STM32内部ADC的误差。虽然精度一般湿度±5%温度±2℃但对于环境监控完全足够。它只需要一个GPIO引脚进行通信。土壤湿度传感器模拟输出款我选用的是最常见的模拟输出传感器。它工作时两个探针之间的电阻会随土壤湿度变化模块内部电路将其转换为0-3.3V的模拟电压输出。STM32的ADC读取这个电压值再通过校准转化为湿度百分比。这里要注意这种传感器长期插在土里容易电解腐蚀最好间歇供电不要一直通电。执行机构继电器模块选用常用的5V驱动、低电平触发的单路继电器模块。STM32的GPIO输出低电平时继电器吸合高电平时断开。模块自带光耦隔离能保护MCU免受水泵等感性负载的干扰。水泵根据灌溉面积选择合适流量的直流潜水泵或微型水泵。关键点在于水泵功率不能超过继电器触点的负载能力。常见的小继电器模块触点容量是10A/250VAC或10A/30VDC。一个12V/5W的小水泵电流大约0.42A远在安全范围内。电源设计这是一个容易忽视但至关重要的部分。系统需要多种电压ESP8266需要3.3VSTM32核心板通常有LDO可从5V转3.3V继电器模块和某些水泵需要5V或12V。建议采用一个12V/2A的直流电源适配器作为总输入。然后通过DC-DC降压模块得到稳定的5V给STM32核心板、继电器线圈供电。STM32核心板上的LDO再从5V生成3.3V给自身和ESP8266、传感器供电。水泵则根据其额定电压选择由12V直接驱动或通过5V驱动。务必确保电源功率充足特别是水泵启动瞬间电流较大。3. 核心电路连接与通信协议制定3.1 硬件接线详解与注意事项接线是实打实的第一步接错了轻则不工作重则烧芯片。下面我详细列出STM32F103RCT6最小系统板与各模块的连接方式并解释为什么这么接。STM32与ESP-01S的连接这是系统的通信主干。我们使用串口2 (USART2)。ESP-01S TX-STM32 PA3 (USART2_RX)ESP-01S RX-STM32 PA2 (USART2_TX)ESP-01S VCC-3.3V(必须确保是稳定的3.3V最好单独一路LDO)ESP-01S GND-GNDESP-01S CH_PD (EN)-3.3V(拉高使能)ESP-01S GPIO0- 悬空或接高电平运行模式。如果需要烧录固件则需在启动时拉低。注意ESP-01S的RX引脚耐受5V但TX输出是3.3V电平。STM32F103的IO口大部分是5V容忍的所以直接连接问题不大。但为了绝对安全或者如果你的STM32是3.3V供电的版本建议在ESP-01S的TX线和STM32的RX之间加一个简单的电平转换电路如两个电阻分压或者直接使用电平转换模块。STM32与DHT11的连接单总线设备接一个GPIO即可例如PA1。DHT11 VCC-3.3VDHT11 GND-GNDDHT11 DATA-STM32 PA1同时需要在该引脚上加一个4.7K-10K的上拉电阻到3.3V。STM32与土壤湿度传感器的连接模拟传感器接ADC引脚。传感器 VCC-3.3V(建议通过STM32的GPIO控制其电源实现间歇供电)传感器 GND-GND传感器 AO (模拟输出)-STM32 PA0 (ADC1_IN0)或其他ADC通道。STM32与继电器模块的连接继电器模块 VCC-5V继电器模块 GND-GND继电器模块 IN (信号线)-STM32 PB0(任意一个GPIO均可)。继电器与水泵的连接继电器模块 COM (公共端)-电源正极 (如12V)继电器模块 NO (常开端)-水泵正极水泵负极-电源负极 (GND)这样当STM32给PB0输出低电平时继电器吸合COM与NO接通水泵得电工作。3.2 串口通信协议与数据包设计STM32和ESP8266之间需要通过串口高效、可靠地交换数据。不能只是随意地发送字符串需要设计一个简单的协议。我采用“帧头命令字数据长度数据内容校验和帧尾”的结构。例如定义STM32发送给ESP8266的数据帧格式如下[0xAA] [0x55] [CMD] [LEN] [DATA...] [SUM] [0x0D] [0x0A]0xAA, 0x55: 固定的帧头用于在数据流中识别一帧的开始。CMD: 命令字。例如0x01代表上传传感器数据0x02代表状态查询。LEN: 后续数据域的长度。DATA: 具体的数据。对于传感器数据我可以将其打包为[温度高8位][温度低8位][湿度高8位][湿度低8位][土壤湿度高8位][土壤湿度低8位]。这样将float或int类型的数据转为两个字节传输。SUM: 从CMD到DATA最后一个字节的累加和校验或异或校验用于验证数据在传输过程中是否出错。0x0D, 0x0A(\r\n): 帧尾方便某些串口助手的观察。同样ESP8266收到OneNET下发的指令后也按照类似的格式打包发给STM32。例如命令字0xA1代表远程控制水泵数据域里用一个字节表示开关状态0x00关0x01开。在STM32的程序中需要编写一个串口中断服务函数进行数据包的接收、解析和校验。只有校验通过的数据包才会被处理这能极大提高通信的可靠性。4. 嵌入式端软件实现与逻辑控制4.1 STM32程序设计数据采集与本地决策STM32的程序主要围绕几个外设展开ADC读取土壤湿度、GPIO模拟时序读取DHT11、定时器进行周期采集、USART与ESP8266通信、以及主循环中的状态判断。DHT11驱动DHT11的时序要求比较严格。它需要MCU先拉低总线至少18ms启动信号然后拉高并等待传感器响应。传感器会拉低80us再拉高80us之后开始传输40位数据16位湿度16位温度8位校验和。每一位数据都以50us的低电平开始高电平的持续时间决定是026-28us还是170us。编写代码时必须禁用中断用微秒级延时函数来精确判断电平持续时间。校验和是前四个字节相加必须与收到的校验和字节相等数据才有效。ADC读取土壤湿度配置ADC为单次转换模式读取连接到土壤湿度传感器AO引脚的通道。由于传感器输出可能受供电电压、土壤成分影响直接读到的ADC值比如0-4095需要校准。我的做法是先将传感器完全干燥时读到的值记为dry_val再将其完全浸入水中时读到的值记为wet_val。那么当前的湿度百分比可以用这个公式估算humidity_percent (float)(wet_val - current_val) / (wet_val - dry_val) * 100.0。这个百分比值可以打包进数据帧。本地控制逻辑这是项目的核心自动功能。在主循环中我会定期比如每10秒检查最新的土壤湿度百分比。我设置一个阈值比如THRESHOLD_LOW 30.0表示土壤湿度低于30%需要浇水。当humidity_percent THRESHOLD_LOW时STM32会控制继电器打开水泵。同时为了防止过度浇水我还会引入一个THRESHOLD_HIGH 60.0和一个状态机。水泵开启后持续监测湿度一旦humidity_percent THRESHOLD_HIGH就关闭水泵。此外必须加入防抖延时比如水泵每次开启后至少运行10秒避免在阈值附近频繁启停。4.2 ESP8266 AT指令流程与网络配置我使用安信可官方AT固件让ESP8266工作在Station模式连接家庭Wi-Fi。STM32通过串口发送AT指令来控制它。流程如下上电初始化STM32发送AT期待返回OK确认模块就绪。设置模式ATCWMODE1设置为Station模式。连接Wi-FiATCWJAPSSID,password。这里有个坑如果密码包含特殊字符需要正确处理。连接成功会返回WIFI CONNECTED和WIFI GOT IP。连接OneNETOneNET支持多种协议我选择最简单的HTTP协议进行数据上报。首先需要建立TCP连接ATCIPSTARTTCP,183.230.40.33,80。这是OneNET的HTTP API服务器地址和端口。上报数据连接成功后就可以构造HTTP POST请求了。STM32需要将传感器数据按照OneNET要求的格式组织成一个JSON字符串然后通过AT指令发送。例如ATCIPSEND长度 POST /devices/你的设备ID/datapoints?type3 HTTP/1.1 api-key: 你的API-KEY Host: api.heclouds.com Content-Length: JSON数据长度 {datastreams:[{id:temp,datapoints:[{value:25}]},{id:humi,datapoints:[{value:60}]},{id:soil,datapoints:[{value:45}]}]}发送完数据后ESP8266会收到服务器的响应如HTTP/1.1 200 OK表示上传成功。这个过程需要STM32有较好的字符串处理能力来拼接AT指令和JSON数据。务必注意每条AT指令发送后要等待并解析ESP8266返回的响应根据响应决定下一步操作实现一个简单的状态机这样才能保证网络通信的健壮性。5. OneNET云平台配置与数据可视化5.1 设备创建与数据流定义首先需要在OneNET官网注册并登录进入开发者中心。在“产品”里创建一个新产品联网方式选择“Wi-Fi”数据协议选择“HTTP”。创建成功后记下产品ID和API Key。然后在这个产品下“添加设备”填写设备名称和鉴权信息可以简单设为设备SN这样就得到了一个设备ID。设备ID、产品ID和API Key是设备接入的三个关键信息。接下来定义数据流。数据流就像是一个数据标签。在这个项目中我们需要创建三个数据流temp温度、humi湿度、soil土壤湿度。OneNET支持动态创建也就是说如果你上报的数据里包含了一个新的数据流ID平台会自动创建它但提前定义好可以让可视化编辑时更方便选择。5.2 数据可视化面板与触发器设置OneNET的“应用管理”或“可视化”工具可以轻松创建监控面板。我们可以添加三个“数值显示”组件分别关联temp、humi、soil这三个数据流。再添加一个“开关”组件关联一个用于控制水泵的数据流比如pump_switch。这样在面板上就能实时看到环境数据并能手动点击开关远程控制水泵。更强大的功能是“触发器”。我们可以设置一个规则当soil数据流的值低于30时自动向设备下发一条指令内容可以是打开水泵。这个下发的指令就是通过HTTP POST发送到OneNET的指令下发API设备ESP8266需要定期向这个API发起查询GET请求来获取指令这就是“命令下发”的流程。不过在我们的架构里本地STM32已经做了自动控制云平台触发器更多是作为一个备份的远程干预手段或者用于发送报警通知比如通过邮件或短信插件当土壤湿度极低时提醒用户。6. 系统联调、问题排查与优化心得6.1 常见问题与诊断方法在实际焊接和调试中我遇到了不少问题这里总结一下ESP8266无法连接Wi-Fi现象一直返回ATCWJAP失败。排查首先用USB转TTL模块单独连接ESP-01S到电脑用串口助手测试排除硬件连接问题。检查SSID和密码是否正确特别是大小写和特殊字符。尝试将路由器信道固定在1-11避免12、13信道某些固件不支持。靠近路由器测试排除信号问题。ESP8266连接OneNET失败现象ATCIPSTART失败或很快断开。排查检查IP地址和端口是否正确。检查设备ID、API Key是否填写正确。确认OneNET产品是否开启了“设备接入开关”。用电脑ping一下api.heclouds.com看网络是否通畅。数据上报成功但平台不显示现象HTTP返回200但OneNET设备数据流里没有更新。排查这是最常遇到的坑仔细检查HTTP POST请求的格式特别是请求头Headers和JSON数据体。必须严格按照OneNET的API文档来。常见的错误有api-key写错了位置或名称Content-Length计算错误JSON格式不对缺少括号或引号。强烈建议先用Postman或curl工具在电脑上模拟发送一次成功后再移植到代码里。土壤湿度读数不准或跳动大现象ADC值不稳定换算的百分比不合理。排查首先给模拟传感器供电的3.3V必须稳定可以在VCC和GND之间加一个10uF的电解电容滤波。其次ADC采样时软件上可以做多次采样取平均。最根本的是土壤湿度传感器本身精度有限且受土壤密度、成分影响大它更适合做趋势判断而非精确计量。可以考虑做更精细的校准在不同湿度土壤中测量并记录ADC值建立查找表。继电器频繁动作或水泵不工作现象在阈值附近水泵频繁启停或者继电器有响声但水泵不转。排查频繁启停是因为没有加入“回差”控制和最小运行时间。在代码里应该设置THRESHOLD_HIGH比THRESHOLD_LOW高出一个区间如20%并且设置水泵一旦开启至少持续运行30秒再判断是否停止。水泵不转先检查继电器是否真的吸合听声音看指示灯再用万用表测量水泵两端是否有电压。可能是电源功率不足水泵启动电流大导致电压被拉低继电器断开。6.2 稳定性优化与进阶思路项目基本跑通后还可以从以下几个方面优化通信可靠性增强在STM32与ESP8266的通信协议中加入超时重发和应答机制。STM32发送一帧数据后启动定时器等待ESP8266返回一个“已收到”的ACK帧。如果超时未收到则重发重发超过一定次数后进入错误处理流程。低功耗设计如果设备是电池供电功耗至关重要。可以让STM32大部分时间处于休眠模式定时唤醒采集数据并上传。DHT11和土壤湿度传感器在非采集时段断电。ESP8266在上传完成后进入深度睡眠模式。本地数据缓存在网络断开时STM32可以将采集到的数据暂时存储在内部的Flash或外接的EEPROM中。等网络恢复后再将积压的数据一次性上报到云端避免数据丢失。OTA远程升级利用ESP8266的OTA功能或者通过OneNET下发升级指令引导STM32从串口接收新的固件并写入Flash实现设备的远程程序更新这对于部署在户外的设备非常有用。多传感器与执行器扩展STM32的资源和GPIO还有富余完全可以增加更多传感器如光照强度传感器、雨水检测传感器让灌溉逻辑更智能例如下雨天不浇水。也可以增加多个继电器控制不同的水泵或电磁阀实现分区域灌溉。这个项目从硬件焊接到软件调试再到云端配置完整地走通了一个物联网应用闭环。过程中遇到的每一个问题都是对电路知识、嵌入式编程和网络协议理解的加深。当你最终在手机OneNET App上看到实时变化的温湿度曲线并远程控制水泵浇灌了阳台上的绿植时那种成就感是单纯的代码练习无法比拟的。它让你真切地感受到代码是如何作用于物理世界解决实际问题的。本文还有配套的精品资源点击获取