简介基于STM32的智能鱼缸项目资料包面向嵌入式初学者与DIY爱好者解决居家养鱼过程中水温检测、水质检测、自动/手动换水、氛围灯变换、自动/手动喂食等实际控制需求。包内共176个文件以STM32的C源码、H头文件、Keil工程文件为核心辅以设计文档PDF/Word、实物接线图JPG、烧录工具EXE及部分调试中间文件压缩包整体约63.54MB目录结构清晰可按模块快速查阅。目前已有5569人学习/下载可用于毕业设计、课程实践或产品原型开发。资料覆盖硬件选型、传感器数据采集、步进电机投食、RGB灯控制、电动马达换水到系统联调完整链路并附有实物演示视频与配套工具方便快速复现和二次开发。 养了半年鱼死了一缸又一缸最后我实在绷不住了决定自己做一个基于STM32的智能鱼缸而且明确要求“本地版”。为什么是本地版因为我不想再被手机App绑定家里Wi-Fi一断鱼缸控制也跟着断这事太蠢了。一个鱼缸而已它的控制逻辑本来就该在本地闭环完成STM32完全扛得住没必要把数据绕一圈云端再回来。这个项目适合谁很简单正在学STM32、想做课程设计或毕业设计的同学以及真的花钱买了鱼却总养不活的懒人。它既能锻炼外设驱动、状态机设计、传感器采集、执行器控制这些基础能力又能让你实实在在得到一个能自动喂食、自动调温、自动开关灯的“不用伺候的鱼缸”。如果你之前只做过点灯、跑马灯这类板级例程那这个项目就是一次典型的“把点灯升级成一个完整系统”的实战机会。1. “本地版”到底意味着什么不联网也能全自动先掰扯清楚“本地版”这三个字。市面上大量智能鱼缸方案都愿意往“云版”靠加一块ESP8266或者ESP32搞个MQTT、配个App看起来高级。但代价是系统复杂度暴涨要处理网络重连、云平台鉴权、协议解析而且一旦断网鱼缸就变成“智障鱼缸”——连定时喂食都做不到。本地版的思路完全不同。所有传感器数据在STM32内部完成采集和处理所有控制决策也由STM32自己做出水泵、气泵、加热棒、喂食器、补光灯全部由板载逻辑直接驱动。你不需要App不需要路由器甚至不需要手机。鱼缸就是一个独立运行的嵌入式设备上电就干活断电再上电照样恢复工作。我当时定的功能清单是这样的实时水温检测低于阈值自动开启加热棒高于阈值自动关闭采用滞回控制避免继电器频繁动作定时/手动双模式喂食用舵机旋转出料仓一次投喂量可调水位监测水位过低时禁止水泵工作防止水泵空转损坏光照控制每天按时间段自动开关LED补光灯OLED屏幕显示实时温度和运行状态按键手动切换参数。这套功能拆开看都不难难的是把它们组合在一起还能稳定跑几个月不出幺蛾子。这正好就是“本地版”的意义所有逻辑都在自己手里出了问题可以排查可以改进而不是对着一个云平台日志发呆。提示如果你是毕业设计选题我强烈建议在论文标题里加上“本地版”这个限定词。它一方面缩小了系统边界另一方面也体现了设计的独立性比满大街的“基于STM32的物联网智能鱼缸”更容易做出深度。2. 硬件选型与电路设计别把钱花在花里胡哨的地方智能鱼缸的硬件方案其实非常成熟难点全在组合和取舍。2.1 主控选型为什么用STM32F103C8T6这个项目用STM32F103C8T6就完全够了不需要上F407、H743。原因很简单鱼缸控制涉及到的外设无外乎ADC、GPIO、定时器、I2C/SPI、UART、PWM这些C8T6全都有64KB Flash跑裸机程序绰绰有余72MHz的主频处理温度采样和控制逻辑也毫无压力。如果手头实在没有C8T6用F103ZET6、F407VET6也完全没问题代码层面几乎不用改多少无非是个别引脚重映射而已。但注意开发板最好选带板载ST-Link接口的最小系统板调试烧录体验会好很多。我自己用的是一块普中或者正点原子那种通用型最小系统板加一个ST-Link V2下载器Keil MDK环境整条链路稳定可靠。2.2 传感器与执行器选型对比这是整个项目中真正需要花心思的地方。我对比过不少方案表格里是最终结论功能方案选择替代方案选择理由水温检测DS18B20防水探头NTC热敏电阻、DHT22DS18B20单总线协议简单防水探头直接扔水里精度±0.5°C读取稳定水位检测不锈钢电极 电压比较器超声波测距、浮球开关简单可靠成本低但要注意电极表面电解问题建议用低压交流或降低采样频率光照检测光敏电阻光敏电阻模块BH1750数字光照传感器光敏电阻模块带比较器和电位器输出数字高低电平代码最简单水泵5V/12V小型潜水泵直流泵 L298N小缸用5V泵配NMOS开关足够功耗低不漏电加热棒220V加热棒 继电器12V加热膜养小鱼缸用大功率就必须走继电器隔离务必注意安全喂食器SG90舵机 3D打印/塑料瓶出料仓步进电机舵机体积小、控制简单、扭矩够用2.3 电源与IO分配电源部分我最开始走了弯路直接用USB线给5V水泵和STM32板共用一个5V电源结果水泵一启动单片机就重启。原因很简单水泵启动瞬间电流冲击大5V电压被拉低STM32掉电复位。后来我把电源分成两路12V/2A适配器作为系统总电源降压到5V给水泵和舵机再通过AMS1117-3.3降到3.3V给STM32和传感器。一个电源模块分离功率地和逻辑地问题就消失了。IO分配建议如下这个分配表是我实际验证过的继电器、蜂鸣器、信号线之间没有冲突外设引脚说明DS18B20PA1单总线接4.7k上拉电阻到3.3V水位电极PA2ADC采样输入通过分压电路接入光敏模块PA3数字输入模块上自带电位器调阈值OLED I2CPB6/PB7SCL/SDA标准I2C舵机PA8定时器1_CH1输出PWM频率50Hz加热继电器PB0高电平触发继电器模块水泵继电器PB1高电平触发继电器模块LED补光灯PB10高电平开启P-MOS或者继电器均可按键1PA11进入设置菜单/确认按键2PA12参数调整/退出蜂鸣器PB3报警输出接三极管驱动注意继电器模块要买带光耦隔离的低电平或高电平触发版本并且线圈两端并联一个1N4007二极管吸收反向电动势否则继电器吸合瞬间的电磁干扰可能直接让STM32的ADC采样数据飘掉。这个坑我后面还会细说。3. 软件架构与核心控制逻辑从裸机循环到状态机系统功能不复杂软件架构也别搞复杂。裸机大循环加定时器中断就够了不需要上FreeRTOS。原因很实在鱼缸控制是慢速过程温度变化以分钟计水位变化以秒计舵机动作偶尔发生多任务实时性要求极低。引入实时操作系统反而增加优先级配置、信号量交互的麻烦调试成本翻倍。3.1 主循环与定时器的分工主循环里做这么几件事读取按键状态、更新OLED显示、状态机的运行。而所有需要精确计时的任务都用定时器中断完成。我用了TIM2作为1ms时基定义了一个软件计数器数组tick[N]每个任务模块各自递减计数。比如水位检测每500ms执行一次温度采集每2秒执行一次OLED刷新每200ms一次。这样一来主循环永远不会被传感器延时卡住按键响应也快。温度采集要重点说一下。DS18B20是单总线协议时序要求比较严格如果直接在主循环里读温度传感器转换期间通常需要750ms整个循环就卡住了。我的做法是在定时器中断里只触发温度转换设置一个标志位主循环检测到转换完成后再去读取。或者更省事一点直接把读DS18B20的函数放在主循环但关闭定时器中断防止时序被破坏读完再恢复。这两种方式我都试过推荐第一种代码更优雅。3.2 状态机把手动和自动模式织在一起整个控制逻辑我用一个简单的状态机组织起来状态A自动运行模式系统根据传感器数据自动控制各执行器状态B参数设置模式用户可调整目标温度、喂食时间、光照时段等状态C手动强制模式临时手动开关水泵、加热棒方便换水冲洗鱼缸。按键1用于在自动模式和设置模式之间切换按键2在参数项之间移动和调节数值。状态切换的核心代码如下浓缩版typedef enum { AUTO_MODE, SET_TEMP_MODE, SET_FEED_TIME_MODE, MANUAL_MODE } SysState; SysState state AUTO_MODE; void StateMachine_Run(void) { switch (state) { case AUTO_MODE: AutoControl_Run(); if (key1_short_press()) state SET_TEMP_MODE; if (key1_long_press()) state MANUAL_MODE; break; case SET_TEMP_MODE: if (key2_short_press()) SetTargetTemp(GetTargetTemp() 0.5); // 上调0.5度 if (key1_short_press()) state SET_FEED_TIME_MODE; break; // 其他状态类似 } }按键消抖不能偷懒我采用的是“消抖标记 定时器扫描”的方式定时器每10ms扫描一次按键连续3次电平一致才认为有效按下和弹开都做过滤。这个处理看似简单但实际使用中能省掉大量玄学问题——鱼缸附近有水汽湿度大按键引脚的ADC和GPIO误触发概率比干燥环境高得多。3.3 温度滞回控制与投喂逻辑加热控制直接靠“低于阈值就开、高于阈值就关”会有个大问题继电器会频繁吸合机械寿命迅速下降而且水温和设定值之间会产生振荡。我用了标准的滞回控制#define HYSTERESIS_VALUE 0.8 // 回差0.8度 if (temp targetTemp - HYSTERESIS_VALUE) Heater_On(); else if (temp targetTemp HYSTERESIS_VALUE) Heater_Off();这样加热器启动和停止之间有一个死区水温会在24.6°C到25.4°C之间自然波动继电器一个小时内只动作几次而不是每分钟都在咔哒咔哒响。投喂逻辑我一开始想得太复杂研究过不同时间点喂不同量、周末跳过喂食等等。后来发现实用场景里根本不需要一个最基本的“每天固定投喂1-2次每次舵机旋转180度”就够用了。用STM32内部的RTC模块做时间基准如果板子没有外接电池断电后时间会丢失这时候就退化成“上电后以当前累计时间为基准的相对时间”模式。如果想省心加一个DS3231 RTC模块断电时间也不丢价格也就几块钱我是强烈建议加的。3.4 水位联锁保护水泵空转是鱼缸损坏的头号杀手。我的逻辑是水位电极检测到低水位信号之后不论自动还是手动模式都强制关闭水泵同时蜂鸣器报警。只有水位恢复正常并且确认解除报警之后水泵才允许重新启动。这个逻辑排布在状态机的最外层相当于一个安全联锁。代码上我单独写成了SafetyCheck()函数放在主循环最前面。别小看这个函数鱼缸漏水、水泵坏掉、水位传感器误报等各种异常场景全靠它兜底。嵌入式开发里功能逻辑可以出问题安全逻辑必须可靠这是我很坚持的一点。4. 踩坑记录与排查经验这些问题实测必现这个项目前后调试了一个多月记录下来的坑不少。挑几个最典型、也最可能复现的写出来按频率从高到低排。4.1 继电器一吸合STM32就重启现象打开加热继电器或者水泵继电器的瞬间OLED闪一下系统重启。排查过程刚开始以为是代码问题加了一堆延时、关了中断仍然会重启。后来用示波器看3.3V供电发现继电器吸合瞬间有一个明显的电压跌落尖峰到2.5V以下直接触发STM32的掉电复位。解决方法给继电器模块单独供电地线单点汇接继电器线圈两端并联续流二极管1N4007在STM32的3.3V引脚旁加100uF电解电容和0.1uF瓷片电容水泵两端并联一个104瓷片电容吸收火花干扰。经过这几步处理后基准电压再也没跌破过3.2V。注意很多人买继电器模块时只关注触发电压高电平低电平忽略了继电器吸合时产生的巨大电动势噪声。凡是电感负载必须加续流二极管这个习惯一定要养成。4.2 DS18B20隔一会儿就读取失败现象温度显示偶尔变成85°C或者空白程序卡在读温度函数里。原因分析85°C是DS18B20上电时的默认温度值出现这个值说明传感器复位了。最常见的原因是单总线没有接上拉电阻或者上拉电阻过大。数据线过长且与电源线走在一起也会干扰时序导致CRC校验不过。解决做法DS18B20数据线接4.7k电阻拉到3.3V线长控制在30cm以内并且不要和继电器输出线绑在一起。如果必须走长线数据线用双绞线并在传感器端多加一个104电容。另外代码里读温度一定要做CRC校验失败就丢弃本次数据继续用上一次的有效值不要因为一次读取失败就卡死主循环。4.3 水位检测电极被电解腐蚀现象水位电极用了两周表面出现一层黑绿色物质检测失灵。原因不锈钢电极通直流电放在水里本质上就是一个电化学腐蚀装置。解决我尝试过几种方案最有效的是降低电极两端电压差和采样频率。具体做法是用一个PWM引脚输出1kHz方波经过RC滤波后变成交流小信号但代码比较复杂。更简单的替代方案是直接用双探针检测模块或者干脆用常开型浮球开关。浮球开关没有电解问题安装也简单就是体积略大。考虑到鱼缸美观和使用难度我个人更推荐浮球开关作为水位检测除非你真的很享受焊电极的乐趣。4.4 光敏模块在夜间误触发现象半夜LED灯突然亮起来早上又自己灭了像是闹鬼。原因光敏模块的电位器阈值调得临界周围有一点杂散光或者阴影变化就会翻转。解决将阈值固定后在软件里加入一段时间延时确认也就是光敏信号连续保持30秒才认为光照状态真的改变了。这种“去抖延时”的思路在处理所有传感器瞬时变化时都好用鱼缸里水流波动、水面反光、水草晃动都会造成干扰没有延时确认机制必出乱子。我整理了一个常见问题速查表照着排查能省去大量时间问题现象可能原因解决方案系统上电后不运行电源功率不足、BOOT0不为0检查适配器电流C8T6最小系统BOOT0接地OLED显示花屏I2C地址错误、接线松动、电平不匹配确认地址0x3C或0x3D上拉电阻4.7k舵机抖动PWM周期不是50Hz、电压不稳TIM配置周期20ms占空比2.5%-12.5%供电与逻辑隔离定时喂食时间不准RTC没有后备电池扩展DS3231模块断电时间不丢失ADC采集数值跳动大参考电压不稳、采样引脚悬空加滤波电容采用DMA多通道连续采集滑动均值滤波下载程序失败驱动异常、供电不足、调试口被禁用选“SWD”模式按住复位键再点下载必要时全片擦除5. 成本核算与项目结构这个方案到底值不值老规矩列一组成本数据。2025年的元器件价格波动不大给一个参考区间器件型号/规格参考价格元STM32F103C8T6最小系统板非官方带ST-Link接口15-25ST-Link V2下载器山寨版即可10-15DS18B20防水探头1米线3-55V小型潜水泵3-5W8-15220V加热棒50W小型15-25继电器模块光耦隔离高电平触发5-10SG90舵机180度5-8OLED显示屏0.96寸I2C8-12光敏电阻模块带比较器2-4浮球开关常开型2-5电源适配器12V/2A10-15各类线材/杜邦线/洞洞板-10-20合计-约100-150比起买一个市售智能鱼缸动辄四五百块这个方案便宜了一大截更重要的是过程里学到的东西远不是几百块能衡量的。工程组织上我建议用HAL库而不是标准库原因只有一个HAL库的代码可读性和移植性比标准库好太多尤其是你要做毕业设计或者后续想在此基础上扩展蓝牙、Wi-Fi、触摸屏HAL库环境下找例程和参考方案更容易。工程目录大概长这样SmartFishTank/ ├── Core/ │ ├── Inc/ │ └── Src/ ├── Drivers/ │ ├── STM32F1xx_HAL_Driver/ │ └── BSP/ │ ├── ds18b20.c │ ├── oled.c │ ├── servo.c │ ├── relay.c │ ├── key.c │ ├── pump.c │ ├── water_level.c │ └── buzzer.c ├── App/ │ ├── control.c │ ├── state_machine.c │ └── data_store.c └── MDK-ARM/BSP层只负责具体外设的驱动App层只负责业务逻辑比如温度滞回控制、喂食调度、状态机迁移。这样分层的最大好处是你想换传感器型号只改BSP层对应文件想改控制策略只改App层其他代码不用动。虽然项目不大但这个习惯从初期就建立起来后面的扩展才不会被屎山代码拖垮。6. 从本地版起步后续升级路径最后聊一点项目之外的东西。很多人做完本地版之后第一反应是“要不要加个ESP8266搞远程控制”。我的建议是先把手上的本地版跑稳一周记录运行数据确认没问题了再考虑扩展。因为远程控制的坑并不在于ESP8266本身而在于你要重新设计整套通信协议、心跳检测、断线重连、异常上报这些加起来的工作量不亚于重新写一遍主控逻辑。本地版是一切的基础。传感器数据采集准不准、控制策略稳不稳、异常处理全不全这些基础功能做扎实之后你把数据通过串口发给ESP8266或者ESP32模块做成MQTT上报只是多一层封装而已。以我的实际体会来说这个项目的最大收获不是鱼缸本身而是让我真正理解了嵌入式系统设计的边界——哪些逻辑该放在本地控制器哪些沟通才需要依赖网络。做技术开发克制比堆功能更难也更重要。鱼缸如此很多项目也都一样。本文还有配套的精品资源点击获取