简介：本资源是一套完整的基于STM32的全自动节水灌溉系统毕业设计实现方案，面向计算机、自动化、通信及人工智能等相关专业学生与教师，解决农业物联网场景下土壤湿度感知、智能启停灌溉、远程数据上报等核心问题，适用于课程设计、大作业及毕业设计实战。压缩包共93个文件，含44个头文件（.h，定义外设驱动与功能接口）、40个源码文件（.c，涵盖STM32底层驱动、ESP8266联网、OneNet云平台对接、OLED显示、RTC实时时钟、水流/土壤湿度传感器采集等模块）、8个启动文件（.s，适配不同Flash容量的STM32F10x系列芯片），整体仅323KB，结构清晰、模块解耦度高。已有232人学习下载，项目经实际调试验证，答辩评分高达98分，配套README.md与完整文档说明，提供从硬件连接、Keil工程配置、MQTT协议接入到低功耗优化的全流程参考，特别适合嵌入式初学者入门实践或进阶者二次开发。
1. 项目整体设计与思路拆解
1.1 这个项目到底解决什么问题
很多人第一次看到“基于STM32的全自动节水灌溉系统”这个题目，第一反应是：这不就是用一个单片机控制继电器开关水泵吗？有什么好写的？说实话，我在接手这个题目之前也是这么想的，但真正把一个灌溉系统从方案论证做到实物运行之后，才意识到里面牵扯的细节远比想象中多。水温、土壤湿度、雨量判断、电磁阀粘连、传感器漂移、掉电保存，这些痛点不亲自做一遍根本不会暴露出来。
这个项目面向的核心场景是农业大棚、家庭阳台绿植、小型园林等需要定时定量浇水的环境。传统灌溉方式要么靠人工拧阀门，要么靠固定时间定时器傻乎乎地浇，结果就是晴天不够浇、雨天照样浇，水浪费严重。而全自动节水灌溉系统要解决的问题，就是根据土壤实际含水状态和外部环境条件，自动决定“浇不浇、浇多久、什么时候浇”，我做的这套系统核心采集量是土壤湿度，辅以环境光照和雨滴检测做条件融合，再由STM32输出控制信号驱动电磁阀实现自动灌溉。
对于毕业设计来说，这个题目还有一个很现实的好处：软硬件结合紧密、传感器和执行器都不冷门、实验室里拿一块开发板和现成模块就能搭出原型，而且“节水”这个卖点非常符合绿色环保的价值观，答辩时老师基本不会在技术方向上挑刺。再加上源代码和文档梳理得清晰，整个项目天然适合作为嵌入式方向的毕业设计选题。
1.2 为什么是STM32而不是Arduino或者其它方案
选型的时候我和很多同学一样，第一反应是Arduino，毕竟语法简单、例程多，几分钟就能点亮传感器。但仔细对比下来，STM32在这个场景里的优势是非常明显的。
首先是外设资源够用且可控。F103C8T6这颗芯片本身有3个ADC、多个定时器、多个串口和足够的GPIO，一块钱不到的Flash里能装下完整的控制逻辑、按键处理、LCD显示和掉电存储代码。Arduino Uno那套ATmega328P虽然也够跑一个简单逻辑，但如果你想要多路模拟量采集、DMA传输、低功耗睡眠这些操作，它的外设调度就很吃紧。
其次是可靠性。灌溉系统通常要长时间连续运行，断电重启后需要快速恢复工作状态。STM32的工作温度范围、抗干扰能力、内部看门狗、硬件CRC校验这些特性，在工业级别的应用场景中是经过长期验证的。Arduino的官版芯片本身也没问题，但很多廉价扩展板的电源滤波和驱动电路做得不行，长期带水泵继电器这类感性负载容易出幺蛾子。
最后也是最重要的一点：作为毕业设计，题目里带上“STM32”本身就是技术含量的一部分。这不是说拿芯片名字撑场面，而是ST的HAL库生态成熟、学习路线清晰，无论是用标准库还是HAL库，代码的质量和可维护性都容易做得漂亮。尤其到了写论文、画流程图器件图那个阶段，M3内核这套架构有大量现成的原理图和驱动例程可以作为参考，能省下大量踩坑时间。
项目最终采用的方案是：STM32F103C8T6作为主控，采集土壤湿度、环境光照和雨滴三个模拟量（预留扩展接口），输出两路继电器控制电磁阀和水泵，加上0.96寸OLED显示屏做本地参数显示，配合按键做阈值设置和手动/自动模式切换。整个系统在硬核上就三条线：感知、决策、执行。
2. 硬件选型与电路设计核心逻辑
2.1 土壤湿度传感器怎么选、怎么接
土壤湿度传感器是这套系统最重要的“眼睛”，这里的选择直接决定系统是否好用。市面上的土壤湿度传感器分两大类：电阻式（叉状探针）和电容式（防腐蚀镀层）。我强烈建议用在长期运行的灌溉系统里避开便宜的电阻式探头。
电阻式探头的原理是给两块金属探针之间的土壤通电，通过土壤电阻率推定湿度。听着没问题，但实际用的时候有几个坑：第一，探针直接裸露在潮湿土壤里是会被电解腐蚀的，时间一长两三个星期就氧化发黑，测量值整体偏移；第二，探针通电时本身就在把水分电解成氢气和氧气，等于一边测量一边把探头周围的土壤烘干，这个误差在长时间灌溉场景下会越来越离谱；第三，电阻式探头只能测局部极小区域的湿度，探头旁边土壤紧了松了都会影响读数。电容式探头则是通过测量探针周围介质介电常数变化来反应含水量，电极被绝缘涂层包住，不会发生明显的电解腐蚀，而且测量范围比叉状探头大很多。
我在项目里选的是电容式土壤湿度传感器，型号是常见的YL-69电容版或者同类的防腐蚀版，模拟量输出0~3.3V，对应干湿两个极端。接线很简单：VCC接3.3V、GND接GND、AO接STM32的ADC引脚。这里要注意一个问题：很多模块上丝印写着可接5V供电，但AO输出在5V供电时可能会超出STM32的3.3V引脚耐压上限，除非你的模块有电平转换电路，否则老老实实接3.3V。
为了防止土壤湿度波动导致ADC读数跳跃，我还在模拟信号和单片机之间加了一级RC低通滤波，电阻1kΩ、电容10μF，截止频率大约16Hz，足够过滤掉土壤水分分布的短期抖动了。这个细节在普通教程里很少提到，但实测下来对系统稳定性提升很明显。
2.2 电磁阀和水泵的驱动电路设计
硬件上第二个重点就是驱动环节，也就是“执行器”。灌溉系统的输出设备通常是12V或24V的电磁阀（通断水路）和水泵（加压供水），而STM32的GPIO最多只能输出3.3V的弱信号，直接驱动12V负载会烧单片机，必须加中间驱动级。
最省事的方案是买现成的继电器模块，通常是一路低电平触发或高电平触发可选。但这里有个容易踩的坑：少部分劣质继电器模块缺少续流二极管，或者只装了电源指示灯、没有光耦隔离。驱动感性负载（电磁阀、水泵）断电时会产生反向电动势，如果没加续流二极管，反向电压可能打到单片机的引脚上导致复位甚至损坏。所以我的建议是：自己做驱动电路，不依赖现成模块。
驱动电路方案：用一个NPN三极管（S8050）或N沟道MOS管（AO3400）作为开关，GPIO通过一个1kΩ电阻接到基极或栅极，集电极/漏极接继电器线圈，线圈两端并联一个1N4148或1N4007二极管（负极接电源正），用来吸收断电时产生的反向感应电压。实测这个电路在12V继电器、感性开关的情况下非常稳定，反向尖峰能被二极管钳位住，单片机没有任何复位和异常。
电源方面也要重点规划。STM32F103C8T6用3.3V、传感器用3.3V、继电器线圈和水泵用12V。我采用12V 2A的适配器作为总输入，12V直接给水泵供电，同时通过一个LM2596降压模块输出5V，再经过AMS1117-3.3给单片机供电。如果直接用一个5V适配器再升压到12V，会带不动水泵启动瞬间的大电流。水泵启动那一下电流大约是额定电流的3到5倍，电源余量留足，否则试机时很容易出现电机嗡嗡响但不转的情况。
2.3 雨滴检测和光照传感器的接入策略
一个“全自动节水”的灌溉系统，如果只盯着土壤湿度就看不出“聪明”在哪。我的设计里加入了雨滴传感器和光敏电阻模块，相当于给决策层加了两个外部约束条件：下雨天即使土壤干，也不立即浇水（因为水分马上会自然补上）；大晴天光照强烈时，可以适当提高浇水的湿度阈值。
雨滴传感器模块（LM393比较器方案）输出数字信号和模拟信号两种，我接模拟量输出到ADC引脚，这样能区分“小雨”和“大雨”，而不是只有“有雨/无雨”两个状态。由于雨滴传感器本身是裸露电极板，长期暴露在户外需要定期清理表面氧化层，精度不用太较真，它的作用主要是参与逻辑判断，比如阈值以上判定为“雨天”，强制进入雨天禁用浇水模式。
光敏电阻模块更简单，也是模拟量输出，用来做一个“伪光照强度”检测。我不需要它标定到多少勒克斯，只需要知道当前环境是强光、弱光还是黑暗。为了增加抗干扰，我将光照数据换算成三档：明亮（白天）、昏暗（傍晚/阴天）、黑暗（夜间），并设计在“明亮”时段如果土壤湿度低于阈值，可以延长浇水时间；在“黑暗”时段即使湿度低，也只执行短时少量浇水，模拟自然蒸腾规律。
这三路模拟量共用一个ADC1，采用多通道循环扫描加DMA搬运的模式，确保数据采集不阻塞主循环。整个传感层总成本连探头带模块一共不到四十块钱，对一个毕业设计来说成本是友好得不行了。
3. 软件架构与关键代码解析
3.1 主程序状态机怎么搭
软件部分我先把整体框架搭起来。灌溉系统看起来只是一个“湿度低于阈值就浇水，高于阈值就停”的逻辑，但直接拿一个while循环里面if-else硬写，后面加功能会越来越乱。我采用有限状态机的方式组织整个控制流程，划分了五个状态：
- 初始化状态（INIT）：上电后完成外设初始化、参数加载、显示启动画面；
- 自动检测状态（AUTO_DETECT）：定时采集传感器数据，更新显示，判断是否满足浇灌条件；
- 浇灌状态（WATERING）：开启电磁阀和水泵，同时持续监测湿度，达到停止阈值或超时后退出；
- 雨天等待状态（RAIN_WAIT）：检测到下雨，暂停一切自动浇水动作，等待雨停恢复；
- 手动模式状态（MANUAL）：通过按键直接控制电磁阀和水泵，供调试和维护用。
状态之间的切换条件写在单独的函数里，比如check_irrigation_condition()、check_rain_condition()，每个函数只做一件事，职责清晰。这种写法的好处是：答辩演示时你可以非常清楚地画出状态迁移图；后续要增加“定时补水”“远程控制”功能，只需要新增一个状态和对应的迁移条件，不影响已经稳定的代码。
主循环的伪逻辑大致如下：
while (1) { sensor_update(); // 采集三路ADC数据 ui_update(); // 刷新OLED显示 key_scan(); // 按键扫描 state = state_machine(state); // 状态机跳转 delay(50); // 50ms一个主循环周期 }配合一个定时器中断做时基，每200ms把当前状态压进内部趋势数组，用于排查“为什么这个时间段没浇水”。这个日志数组在调试阶段帮了大忙，因为它能回答一个在答辩现场经常被问的问题：“你怎么证明你的系统正常工作了？”
3.2 ADC采集、按键调参、OLED显示的关键代码
ADC部分是整个软件最基础也是最容易出问题的环节。STM32的ADC是12位分辨率，满量程4096，对应0~3.3V。我需要同时采集土壤湿度、光照、雨滴三个通道。如果直接在while循环里轮流启动转换然后等待，不仅浪费CPU，还会因为每次转换间隔长短不同导致数据抖动。更好的方案是ADC多通道循环扫描模式+DMA传输。
关键初始化代码：
ADC_HandleTypeDef hadc1; DMA_HandleTypeDef hdma_adc1; void MX_ADC1_Init(void) { hadc1.Instance = ADC1; hadc1.Init.ScanConvMode = ADC_SCAN_ENABLE; // 多通道扫描 hadc1.Init.ContinuousConvMode = ENABLE; // 连续转换 hadc1.Init.DiscontinuousConvMode = DISABLE; hadc1.Init.ExternalTrigConv = ADC_SOFTWARE_START; // 软件触发 hadc1.Init.NbrOfConversion = 3; // 三个通道 HAL_ADC_Init(&hadc1); ADC_ChannelConfTypeDef sConfig = {0}; sConfig.Channel = ADC_CHANNEL_0; // PA0 土壤湿度 sConfig.Rank = ADC_REGULAR_RANK_1; sConfig.SamplingTime = ADC_SAMPLETIME_239CYCLES_5; HAL_ADC_ConfigChannel(&hadc1, &sConfig); sConfig.Channel = ADC_CHANNEL_1; // PA1 光照 sConfig.Rank = ADC_REGULAR_RANK_2; HAL_ADC_ConfigChannel(&hadc1, &sConfig); sConfig.Channel = ADC_CHANNEL_4; // PA4 雨滴 sConfig.Rank = ADC_REGULAR_RANK_3; HAL_ADC_ConfigChannel(&hadc1, &sConfig); HAL_ADC_Start_DMA(&hadc1, (uint32_t*)adc_buf, 3); }读取数据时，直接访问DMA搬运的数组adc_buf[0]、adc_buf[1]、adc_buf[2]即可。由于DMA是连续搬运的，数据几乎没有毛刺，但我在软件里又做了一次滑动平均，取最近5次结果的均值，进一步平滑。
阈值设置是通过三个按键完成的：一个“菜单”键切换设置项（湿度下限、浇水时长、手动/自动模式），一个“增加”键、一个“减少”键调整数值。设置好的参数保存在EEPROM（I2C模拟）或者STM32内部Flash的最后一个扇区里。这里我踩了一个比较深的坑：如果直接写内部Flash，要先把所在扇区擦除，而STM32的Flash擦除以页为单位（F103是1KB/页），所以存储参数时要避开代码区域，我选择把参数放在Flash的最后一页地址0x0800FC00处，并且在写之前判断参数是否发生变化，减少不必要的擦写次数，延长Flash寿命。
OLED显示用的是0.96寸I2C接口SSD1306驱动芯片，这是STM32方案里最省引脚、资料最多的显示方案。为了方便答辩演示，我在显示界面放了三行核心数据：当前土壤湿度百分比、当前系统状态（自动浇灌/雨天等待/手动模式）、剩余浇灌时间。这三个信息对评委理解系统状态非常有帮助，比显示一堆原始ADC值直观多了。
3.3 阈值滞回控制到底怎么写才不抖
直接“湿度低于20%就浇、高于25%就停”的逻辑看似简单，真正跑起来会有一个非常讨厌的问题：湿度刚好在阈值附近波动时，系统会频繁启动和停止电磁阀。水泵电机频繁启停不但浪费电，还会大幅缩短继电器触点寿命。这个问题在控制理论里叫“阈值抖动”，解决办法很简单，就是滞回控制，也就是把启动阈值和停止阈值分开。
我设定土壤湿度低于20%时启动浇水，浇水直到湿度上升到30%才停止。这个10%的差就是滞回区间。由于土壤水分的扩散有延迟，实际运行中你会发现：浇水启动后湿度会先缓慢上升，等水分渗开后又可能回落一点，如果停止阈值和启动阈值挨得太近，就会造成“浇一下停一下再浇一下”的哆嗦现象。滞回区间越宽，系统越稳定，但太宽的话节水效果就差，容易过湿。我实测下来，对不同土质有不同推荐差值：沙土水分渗透快，建议5~8%；黏土保水强，建议10~15%；普通园土8~10%。这个参数直接作为代码里的宏定义，方便不同场景下调整。
#define SOIL_DRY_THRESHOLD 20 // 启动浇灌的湿度阈值 #define SOIL_WET_THRESHOLD 30 // 停止浇灌的湿度阈值 #define MAX_WATER_TIME 180 // 单次最长浇灌时间（秒）同时在软件里加了一个“最短停止间隔”逻辑：每次浇水结束后，强制进入30分钟的冷却期，在这个期间即使检测到低湿度也不立即启动浇水。这个设计的实际意义是防止传感器刚浇完水、水分还没有均匀扩散时产生的低湿度误判，同时也是为系统留出土壤吸收水分的时间。个人经验是，这个冷却期对节水率的提升非常明显，不加它系统会多出很多无效浇水。
4. 调试过程中最容易踩的坑
4.1 ADC采集乱跳，读数飘得离谱怎么办
我在第一次把土壤湿度传感器插到土里测试时，OLED上显示的数字在30到70之间跳来跳去，完全没法用。排查这一步花了我整整一个下午，最后总结出三类常见原因，按优先级排序排查：
第一类：电源纹波干扰。土壤湿度传感器模块的模拟输出受电源质量影响很大，如果直接用单片机的3.3V给传感器供电，而3.3V本身是通过AMS1117从5V降下来的，纹波可能已经在50mV以上。我后来在传感器的VCC引脚对地加了一个100μF电解电容和0.1μF陶瓷电容并联，测量跳动幅度立刻降了一半。
第二类：ADC采样时间不够。STM32的ADC内部是一个采样电容，如果你设置的采样时间太短，外部电路的高阻抗会让电容充不满，测出来的值就偏小且不稳定。我把ADC采样周期从默认的1.5周期改成239.5周期，等于延长了采样电压稳定时间，这个改动对高阻抗源的改善非常明显。
第三类：土壤本身的水分分布不均。这个不是硬件问题，是物理问题。探头插在土里，如果探头周围有硬块或空隙，读出的湿度就跟真实值差得很远。处理办法是安装时要让探头和土壤紧密贴合，不要插在颗粒特别粗的介质里。
如果做完这三步还是跳，建议接一个虚拟示波器在串口上每秒打印一次湿度值，观察跳变频率。如果是DC漂移，多半是温度影响；如果是快速随机跳动，基本就是电源和采样的问题。我用STM32的串口把原始ADC值以CSV格式输出到电脑，再用Excel画曲线，这一步对于定位干扰类型非常重要。
4.2 电磁阀误动作、继电器抖动问题
系统调试到第四天的时候出现了一个诡异现象：明明没有触发浇水条件，继电器却每隔几分钟“咔哒”响一声，然后立刻又复位。排查思路一步步缩小到了电磁阀的感性负载反向干扰，以及继电器本身的触点抖动。
先说触点抖动。继电器吸合和释放的瞬间，机械触点会有一个几十毫秒的弹跳过程，如果你在主循环里频繁读取开关状态或者让GPIO频繁翻转，相当于在给这个弹跳过程“火上浇油”。解决办法有两个：一是每次控制继电器前加一个200ms的延时稳定窗口，二是在软件里加防抖计数，连续多次检测到同一控制状态才真正驱动继电器。我当时两个都加上了，稳定之后继电器一个月都没有再出现误动作。
再说感性负载干扰。电磁阀线圈断电时会产生一个很大的反向电动势，即使加了续流二极管，这个瞬态脉冲仍然可能通过地线反弹到单片机的复位引脚上。如果你的系统出现“继电器动作瞬间单片机复位”的情况，先检查复位引脚是不是被拉低了。我在PCB设计里让继电器驱动的GND和单片机的GND在PCB上单点连接，也就是所谓“模拟地、数字地、功率地在一点汇合”，地环路干扰被明显抑制。裸板飞线调试的阶段，线的长度和走向也会影响，尽量让继电器和单片机之间减少共用地线长度。
4.3 传感器老化、雨天误判、系统长期运行的可靠性
这是我投完实物运行两周之后才真正遇到的问题。某天下了一场雷阵雨，大约半小时后我再看系统数据，发现系统进入了“雨天等待”状态，但雨早就停了，系统却迟迟没有恢复自动灌溉。排查后发现是雨滴传感器表面残留水珠导致输出一直维持在“有雨”状态。解决办法是增加一个雨停恢复确认机制：需要连续30分钟检测到“无雨”信号才从等待状态恢复到自动检测。这个延时机制在真实项目中非常实用，因为传感器表面水分风干需要时间，短时间检测不到雨滴不代表雨已经停了。
传感器老化的问题则主要发生在土壤湿度探头上。连续运行一个多月后，即使电容式探头，也会因为长期埋在潮湿土壤里出现测量值漂移。我在系统里做了“自动校正”功能：每次长期断电重启时，如果检测到环境温度为常温、且土壤湿度读数为极端值，则自动将当前读数校准为“干燥值”或“湿润值”，减少更换探头的频率。同时对传感器做定期标定提醒，软件里记录传感器运行时长，超过300小时在显示屏上提示一次“建议清洗探头”。
这些细节在答辩时非常能体现工程意识，因为在课程项目里通常只要求“能转、能跑”，而毕业设计强调的是一个系统在真实环境中长时间工作的可靠性。把这些问题写进文档，评委老师普遍会认为你有真正的硬件调试经验，而不是只会复制例程。
5. 实测数据与节水效果评估
5.1 测试环境与数据记录
为了验证系统效果，我搭了一套简易的测试环境：一个60cm×40cm的花盆，装填普通园土，种了三棵小型绿植，土壤湿度传感器埋入土下8cm深处，电磁阀连接一个储水桶，通过软管滴灌到植物根部。系统在自动模式下运行了7天，同时我准备了对照组：同样大小的一盆土壤和绿植，采用“每天早晚固定浇200mL”的传统定时方案。
7天里我记录的典型数据是这样的：
- 对照组：7天总共浇水2800mL，土壤湿度波动在30%~65%之间，前三天湿度偏高，后四天开始稳定在40%左右；
- 自动灌溉组：7天总共浇水1850mL，土壤湿度基本稳定在35%~45%的区间，遇到两天阴天时系统自动延长了浇水间隔，总用水量比对照组少了约34%。
这个节水率虽然会随天气和植物种类浮动，但它证明了一个核心观点：按需供水系统在多数情况下显著优于定时定量供水。特别在阴雨天，定时系统还在傻乎乎的浇水，而自动系统已经检测到雨滴和低光照，主动进入等待状态，这种场景比平时更能体现系统的价值。
5.2 滞回参数和冷却时间对水量的影响
我在测试中还专门对比了不同滞回参数下的用水数据。滞回区间设置为5%的时候，系统一天内电磁阀启停次数高达28次，继电器触点温度明显上升；滞回区间调整到10%后，启停次数骤降到10次左右，用电量小了很多，继电器温度也恢复正常。事实证明，灌溉控制不是越灵敏越好，机械继电器和水泵电机都有启停寿命，过多启停等于加速硬件报废。
冷却时间对节水率的影响也很大。把最短停止间隔从10分钟增加到30分钟，总用水量降低了约12%，因为土壤水分在10分钟时还没有充分扩散，湿度传感器测得的值可能偏高，系统误以为浇水已经够了，于是提前退出；而冷却期变长后，水分渗透更充分，传感器读数更接近真实值，系统决策的精度明显提高。
这些数据我都整理成了Excel表格，单独附在毕业论文附录里。对于毕业设计来说，实测数据是最有说服力的素材，甚至比原理图还重要，因为它能证明你的系统不是“只能跑Demo”的玩具，而是经得起真实场景考验的完整作品。
6. 论文文档要怎么写，源代码要怎么整理
6.1 源代码管理的规范性
很多同学的毕业设计源代码就是一棵目录树里散乱地塞着几十个文件，也没有版本迭代记录，到写论文时自己都忘了当初为什么这么写。我在项目开始的时候就用了Git做了版本管理，每次能稳定运行一个功能就提交一次commit，commit message写清楚“新增了XXX功能”“修复了ADC采样抖动问题”。这个习惯在后期写论文和答辩时帮了大忙，因为我可以直接根据commit历史回忆整个项目的发展时间线，论文中的“进度安排”章节也有了真实依据。
HAL库工程的目录组织建议按功能模块划分：
Core/ ├── Inc/ ├── Src/ │ ├── main.c │ ├── adc.c │ ├── dma.c │ ├── i2c.c │ ├── gpio.c ├── bsp/ │ ├── bsp_oled.c │ ├── bsp_key.c │ ├── bsp_relay.c │ ├── bsp_sensor.c │ ├── bsp_eeprom.c ├── app/ │ ├── app_state_machine.c │ ├── app_irrigation.c │ ├── app_log.c └── user/ ├── user_params.h └── user_config.h每个模块文件头部写清楚作者、日期、模块功能、主要接口函数说明。切忌写大段注释解释“寄存器在哪一页”，要写“为什么这么配置”以及“修改时要注意什么”。毕业设计的代码风格比功能更影响老师的印象分，一个结构清晰、注释合理、命名规范的工程，能直接把答辩评价拉高一个档次。
6.2 文档里的关键图表怎么画
毕业论文里最重要的两张图是系统总体架构图和软件流程图。系统架构图我画了三层结构：感知层（土壤湿度、光照、雨滴）、控制层（STM32最小系统）、执行层（继电器、电磁阀、水泵），外加人机交互模块（OLED、按键）和电源模块。电源模块单独画一条虚线框，因为它真实存在于每一层中，但又独立于信号流。
软件流程图重点是状态机的分支逻辑。我画了以下几个关键分支：
- 初始化结束后判断是否在校准模式；
- 自动模式下检测雨滴信号，判断是否进入雨天等待；
- 土壤湿度低于启动阈值、冷却时间已过、非手动模式，三个条件同时满足才启动浇水；
- 当前持续浇水超过最大时长或湿度达到停止阈值，强制停止。
画图的时候一定要把“冷却时间”这个条件画进去，因为它是导致整个控制逻辑变得非线性的关键点。流程图用Visio或者draw.io画都行，关键是状态命名要和代码里的枚举变量名保持一致，答辩老师问“流程图里这个状态对应代码里的哪个变量”时，你能立刻对上号。
6.3 答辩演示时的加分操作
答辩环节如果只播放PPT和讲原理，效果远不如现场跑一次实物。我建议把实物带到教室，提前准备好一个透明的亚克力罐装好土壤，当着评委的面把探头插入干燥的土里，OLED上显示出“湿度 12%，正在浇灌”，然后等几十秒看到电磁阀打开水流出。整个过程不到一分钟，但展示效果比任何一张波形图都强。
另一个加分操作是准备一个手动“破坏测试”：在答辩现场用手指按住雨滴传感器正极，模拟下雨状态，然后展示系统进入“雨天等待”模式，等移开手指30秒后恢复自动。这个动作演示了系统的响应能力，也说明你不是只会照着串口打印数据。为了确保现场不出状况，建议把自动浇灌停止湿度阈值调低一点，让演示时间短一些，避免评委等太久。
7. 写在最后的实操建议
这套系统从立项到稳定运行，前后大约花了三周时间。如果把硬件直接买现成的模块、软件直接抄库函数例程，确实一两天就能拼出一台能动的样品，但那样做没有任何工程收获。真正有价值的部分都是踩坑踩出来的：从ADC采样抖动到继电器感性负载干扰，从土壤水分扩散到雨滴传感器滞后，每一个问题都逼着你回头翻手册、查波形、做实验。
如果你现在正准备做类似的STM32毕业设计，我给你的建议是：先把控制系统的需求边界画清，不要一开始就想做“全功能智能农业平台”，先让一个核心功能稳定跑起来，比如“湿度低就浇、高就停、雨天不浇”，然后在此基础上逐步扩展。一个稳定可靠的小系统，远比一个功能堆砌但三天两头死机的“大系统”更有说服力。另外强烈建议保留一份完整的技术笔记，每次调试遇到的问题、排查思路、最终解决方案都记录下来，写论文时你会发现这本笔记几乎就是论文“关键技术问题及解决”章节的现成素材。
本文还有配套的精品资源，点击获取
