简介:面向 STM32 与物联网开发爱好者,这套智能鱼缸方案以 STM32F103RCT6 为主控,配合华为云 IoT 平台与 WiFi 模块,实现设备联网与手机 APP 远程管理。资源包约 112.91MB,含完整项目源码、设计文档、原理图、Android 与 Windows 端上位机及相关工具,结构清晰,适合对照学习与二次开发。功能覆盖浊度检测、超标自动报警并开启水泵换水,支持定时或手动喂食、补氧,水温加热上限可在 APP 设定,并可实时查看浑浊度、温度,随时修改喂食与补氧间隔,涵盖智能鱼缸常见场景。已有 1375 人浏览学习,对正在做课程设计、毕业设计或物联网入门实战的开发者,这套可复用、可扩展的工程样例具有较高参考价值。
1. 项目整体设计思路拆解:为什么用STM32+华为云IoT做智能鱼缸
先说说这个项目的价值。市面上所谓“智能鱼缸”大多是定时插座加一个加热棒,靠红外遥控器操作,人出门旅游就只能赌鱼命。我自己养鱼踩过几次坑之后,决定用STM32做主控、ESP-01S做联网模块,把整个鱼缸的传感器数据丢到华为云IoT平台上去,实现远程看水温、远程喂食、远程控制灯光和水泵,温度异常了手机端还能收到告警。这套方案做完之后,最大的感受是:鱼缸本身不复杂,复杂的是怎么让单片机稳定接入云平台,并且保证命令下发的响应及时可靠。
整套系统的链路是这样走的:STM32F103C8T6负责采集水温、空气温湿度、水位和光照信号,同时驱动水泵、LED灯和投喂电机;ESP-01S和STM32通过串口连接,用AT指令把数据以MQTT协议上报到华为云IoT,再订阅云端的命令Topic,收到“开灯”“喂食”这类JSON指令之后,STM32解析字段并执行对应的IO动作。用户在手机端登录华为云IoT平台或者自己写个简单网页,就能看到实时数据,也能远程触发执行器。整个过程不需要自建MQTT服务器,平台免费额度足够个人项目和毕业设计使用,省去了一堆运维烦恼。
这个方案适合三类人:一是准备做嵌入式毕业设计的学生,二是想入门物联网云平台开发的工程师,三是想低成本改造家里鱼缸的DIY玩家。只要你能接受用Keil写STM32代码,手里有万用表和电烙铁,整个过程大概一周左右就能跑通。
2. 硬件选型与电路设计细节
2.1 主控与联网模块的选型逻辑
在Stm32的选型上,我推荐STM32F103C8T6,也就是常说的“蓝丸板”。它便宜、资料多、3.3V逻辑电平,引脚足够覆盖这个项目的外设需求:一个串口给ESP-01S,另一路串口做调试打印,剩余引脚接传感器和继电器,ADC通道刚好够。最重要的是它拥有丰富的中断和定时器资源,可以支撑后面我会提到的“串口状态机接收”和“定时采集任务”这类非阻塞编程方式。
联网模块我们选了ESP-01S,这是ESP8266的简化封装,只有8个引脚,PCB天线,成本控制在正常范围内。选择它的核心原因有两个:一是它自带TCP/IP协议栈和WiFi协议栈,STM32不需要处理复杂的网络层逻辑,只需要通过UART和它通信,这条路径在大量项目里被验证过;二是市面上常见的AT固件附带MQTT命令集,用AT+MQTTUSERCFG、AT+MQTTCONN就能完成连接,不用在MCU里移植MQTT客户端库,开发周期大幅缩短。
2.2 传感器和执行器的接口方案
水温采集我用DS18B20,单总线协议,一根线就能读数据,精度能达到0.5摄氏度以内。这个传感器有多个封装,防水探头版直接丢进鱼缸里,用GPIO口模拟时序读取即可。空气温湿度用DHT11虽然精度一般,但胜在便宜、代码简单,用来监测鱼缸上方环境温湿度足够了。如果你想做水质监测,可以加一组TDS模块检测溶解性固体,但注意TDS探头不能干放,要浸泡在流动水体中。
水位监测我用的是电极式水位传感器,通过两路探针检测高低水位。它有数字和模拟两种输出,数字量用来判断水泵抽水时是否缺水,模拟量用来辅助计算水体水位等级。执行器这块,水泵选5V或12V小型潜水泵,用继电器模块控制通断;LED照明灯可以选普通灯带,用MOS管做PWM调光更顺滑。鱼缸投喂电机选步进或减速电机,控制投食转盘转动角度即可。
2.3 电源架构与布线避坑
很多人把这套系统焊完之后发现单片机频繁重启,十有八九是电源纹波问题。我的建议是采用三级电源架构:外部12V适配器进来,经过DC-DC降到5V给继电器和水泵驱动器供电,再用AMS1117-3.3给STM32和ESP-01S供电。继电器线圈必须由5V驱动,不能直接挂在3.3V上;水泵等感性负载两端要并联续流二极管,防止关断瞬间反向电动势打坏MOS管或者干扰单片机上电时序。
ALTERNATIVELY,你也可以用USB供电,但水泵和继电器同时动作时,USB口的5V会被拉低到4.2V以下,系统稳定性会明显下降。所以建议大家直接买12V电源,走“12V→5V→3.3V”这条链路,并且在STM32供电入口加一个100uF电解电容和0.1uF瓷片电容,实测下来系统复位概率能下降一个数量级。电源地线要粗,传感器地要和单片机地单点相连接,不要形成环地。
3. 华为云IoT平台接入配置详细说明
3.1 创建产品和注册设备
在华为云控制台搜索“IoTDA”,也就是设备接入服务,进入后先创建产品。产品名称填“SmartFishTank”,协议选择MQTT,数据格式选择JSON,设备类型选自定义或智能家居。创建完成后,需要在这个产品下定义产品模型(Profile),这一步非常关键:产品模型里的属性名称必须和设备上报JSON里的键完全一致,否则平台会丢弃数据。
我建议在模型里建两个服务:一个叫“Environment”,属性包括temperature(水温)、humidity(空气湿度)、waterLevel(水位);另一个叫“Control”,属性包括lightStatus、pumpStatus、feederStatus。每个属性设置好数据类型,比如temperature用int型表示,单位摄氏度的100倍,也就是10代表0.1度,用整数传输能降低解析开销。属性上报频率不用高,10秒一次足够,避免云平台按消息量计费时产生额外成本。
完成产品定义后,在设备列表注册一个设备,拿到设备ID(device_id)和设备密钥(deviceSecret)。这两个值后面计算MQTT的clientId和password时要用,建议直接记在工程配置头文件里。需要注意,华为云的设备接入域名在不同区域不一样,我使用的是北京四的默认接口地址:iot-mqtts.cn-north-4.myhuaweicloud.com,端口1883走明文TCP。
3.2 MQTT参数计算与连接规则
这块是大家卡住最多的地方。华为云IoT对MQTT连接的鉴权有固定格式:clientId取“device_id_0_0_时间戳”,0和0分别代表设备配置和扩展信息,timestamp是Unix时间戳;username就是设备ID本身;password不是明文密钥,而是使用设备密钥对timestamp做HMAC-SHA256计算后得到的小写十六进制字符串。
因为ESP-01S的AT指令里只需要填入计算好的clientId和password,所以这个hash计算得在PC上提前完成或在PC端工具中算好。如果你用Python验证,可以这样实现:
import hmac, hashlib, time
device_id = "你的设备ID"
device_secret = "你的设备密钥"
timestamp = str(int(time.time()))
client_id = f"{device_id}_0_0_{timestamp}"
username = device_id
password = hmac.new(
device_secret.encode(),
timestamp.encode(),
hashlib.sha256
).hexdigest()
print("clientId:", client_id)
print("username:", username)
print("password:", password)
上面的timestamp需要每2小时刷新一次,否则云端会判定过期。对于长时间运行的项目,我建议STM32通过NTP或取平台下发时间的方式更新时间戳,重新走一遍MQTT连接流程。简单场景下,也可以用AT+MQTTCONN建立连接成功之后,配置每30秒发一次 AT+MQTTPING 保活,连接可以维持一整天不松动。
3.3 标准Topic设计
华为云IoT平台定义了一批标准Topic,我们只要按规则发布和订阅就行。属性上报用 $oc/devices/{device_id}/sys/properties/report ,Body格式是:
{
"services": [
{
"service_id": "Environment",
"properties": {
"temperature": 26.3,
"humidity": 55,
"waterLevel": 85
}
}
]
}
云端下发命令时,设备订阅 $oc/devices/{device_id}/sys/commands/# 通配符Topic,回复命令响应时往 $oc/devices/{device_id}/sys/commands/response/request_id={request_id} 发送消息即可。这里的request_id是从下发命令Topic里截取出来的,回复的JSON里sequence对应命令系统自动生成的序号。这样设计的好处是平台能准确知道命令是否执行成功,用户界面能看到超时状态。
4. STM32端核心代码与调试过程
4.1 串口状态机和AT指令发送队列
最开始我直接把AT指令用printf发出去,再用HAL_UART_Receive_IT中断收数据,结果发现严重问题:ESP-01S返回的“OK”和“ERROR”经常被中断肢解,半包处理逻辑写得乱七八糟。后来我改成统一框架:用环形缓冲区收串口字节,收到 \r\n 就认为是一行完整响应,把响应行挂到解析队列中;主循环轮询队列,匹配关键字。
在代码层面,发送AT指令也要排队。我定义了一个结构体数组,每个元素存放完整的AT指令字符串和超时时间,执行完一条再发下一条。ESP-01S的AT命令是按顺序执行的,你不能在连接WiFi的过程中同时去发MQTT连接指令,否则模组直接返回 ERROR 。
4.2 数据采集PWM控制和上报逻辑
DS18B20的读取代码在STM32上非常成熟,我直接用了GPIO模拟时序,延时函数基于SysTick实现。注意DS18B20的时序要求很严格,在启用中断的条件下容易读错,所以我在读温度时关中断一小会儿,读完后恢复。ADC采集水位和TDS信号就直接用HAL库,DMA循环采样16次取平均值,避免单个采样点波动导致误判。
执行器的控制逻辑是在一个10毫秒定时器里面做的,开灯和关灯只需要操作GPIO,水泵也是普通开关量,但投喂电机需要控制旋转时间。我在Live调速上用PWM控制一个小型直流电机,实现0到100%的调速,给鱼缸灯光调光时也可以用同一通道。
每条上报数据在上云之前先构建JSON字符串,用sprintf拼进发送缓冲区。这里有一个易错点:ESP-01S的 AT+MQTTPUB 最多支持512字节payload,所以属性上报一定要精简,只报核心数据和时间戳。拼接完成之后发 AT+MQTTPUB=0,"$oc/devices/xxx/sys/properties/report",1,1 ,后面紧跟payload长度,再发送具体数据,ESP-01S返回 OK 即表示上报成功。
4.3 命令下发解析与执行
命令下发的处理是整个项目的灵魂。ESP-01S收到MQTT下行消息后会通过UART返回一行数据,格式类似 +MQTTSUBRECV:0,"$oc/devices/xxx/sys/commands/request_id=12345",66 换行后跟JSON体。我拿这一行做字符串匹配,先判断是否包含 commands/request_id ,再提取request_id和payload。
提取到payload之后,由于STM32端不方便直接引用复杂JSON库,我采用了一个非常轻量的解析思路:从JSON文本里找 "command_name" 和 "paras" 对应的键值,逐个匹配字符串。控制指令里一般只需要 "command_name":"LightControl","paras":{"status":1} ,我只需要判断 LightControl 是否存在、 status 是0还是1即可。这个方式虽然简单,但非常抗造,而且不占用过多RAM。
收到命令后执行IO操作,操作完成后根据request_id拼装响应Topic,向 $oc/devices/xxx/sys/commands/response/request_id=xxx 发布响应消息,这样华为云平台立刻能看到命令执行结果。实测命令下发到IO动作的端到端时延大约300毫秒以内,体验相当流畅。
4.4 网络异常自动恢复机制
WiFi和MQTT连接不是永远稳定的,尤其是家用路由器隔几天重启一次,ESP-01S的TCP连接会无声断开。我给系统设计了三层检测机制:第一层是AT指令发送超时,超过3秒没收到响应就认为模组卡死,重新初始化;第二层是MQTT keepalive超时,如果 AT+MQTTPING 连续三次没有返回 OK ,主动断开MQTT连接重新连接;第三层是WiFi连接状态检测,周期性发送 AT+CWJAP? 查询是否还在线,如果返回的IP是 0.0.0.0 ,说明WiFi断了,重新执行 AT+CWJAP 连接。
这套机制跑下来,我在实际使用中连续运行一周不手动重启,系统依然正常。需要注意的是ESP-01S重新连WiFi需要10秒左右,此期间所有上报数据会暂时缓存到环形队列里,最多保留最近50条,等重新连接之后按时间戳补报,避免云平台历史数据链断裂。
5. 常见问题与排查技巧实录
5.1 串口通信与传感器读数异常
| 现象 | 可能原因 | 排查方法 |
|---|---|---|
| ESP-01S完全无反应 | 供电不足或波特率不匹配 | 测量VCC是否稳定3.3V,确认串口波特率是否设置为115200 |
| 收到的AT响应乱码 | 共地不良 | 确保STM32和ESP-01S共地后再交换数据线 |
| DS18B20读到85℃ | 单总线时序异常或上拉电阻缺失 | 数据线加4.7kΩ上拉电阻,读周期前关闭中断 |
| ADC水位数值跳变 | 探头信号干扰 | 开启DMA循环采样,做平均值滤波,采样间隔拉长 |
ESP-01S自身是3.3V供电,但它启动瞬间电流能达到300mA,如果板载稳压器输出能力不足,就会一直复位。建议USB转TTL和ESP-01S分别供电,再以公共地相连,实测非常稳定。在传感器环节,我踩过比较大的坑是DHT11的采样间隔不能小于1秒,否则返回的湿度数据永远是上一次的值,很多人误以为传感器坏了,其实是读取时序太频繁了。
5.2 MQTT连接与数据上报问题
华为云IoT最常见的连接失败,排在第一位的是password计算错误。如果你在设备列表里看到设备状态一直是“未激活”,那基本就是clientId、username、password三者对不上。建议先用PC端的MQTT工具配合华为云提供的调试widget验证连接参数,等PC端能连上之后再下放到AT指令去连,思路会清晰很多。
还有个容易忽略的点是华为云IoT的MQTT端口分为1883明文和8883加密。ESP-01S这种老模组不支持TLS,只能选1883明文。如果选了8883,TCP握手阶段就会出现 AT+MQTTCONN 挂死。数据上报成功但平台看不到时,检查JSON的services数组里service_id是否存在且与产品模型一致,properties里的属性名是否精确匹配,尤其是大小写。我在调试时还发现json里的数值不能带多余空格,ESP-01S不会帮你格式化,只会原样上传,平台解析严格会让多余空格前的属性失败。
5.3 远程命令执行不稳定的排查
命令下发执行不稳定的情况,大多出现在订阅Topic的request_id解析上。如果程序是整体读取Topic字符串再截取request_id,一旦命令体里有换行符,截取位置就会错位。我建议直接用“先按行分割,再定位 request_id= ”的方式,而不是按字节偏移找值。另外,设备订阅的Topic结尾要用 # 通配符,如果只订阅完整的固定Topic,云端带不同request_id的下发命令全都收不到。
关于命令响应,有两点经验:第一,收到命令后要立即打印响应日志,确认request_id确实取到了;第二,响应消息里需要包含 result_code 字段,0表示成功,非0表示失败。华为云平台在收到响应后才会把命令状态改成成功,否则等超时再失败,用户在界面端看到的是超时而非执行结果,这个体验差很远。
6. 一次完整调试验证与扩展思考
在整条链路联调通过后,我在办公室用了一个小玻璃缸跑了两周。白天气温高,水温读数一般在25到27度之间浮动;晚上我会远程关灯、开启增氧泵。通过华为云IoT平台的历史数据曲线,能清楚看到每天温度波动的周期,这和预期完全匹配。
中间也发现一个小问题:为了省钱,我用的电极式水位传感器在长期浸泡后表面会结水垢,读数从原本的80%慢慢漂移到60%。后来我改成每周自动冲洗探头一次,让水泵反转3秒,同时在软件里做了零点标定,数据就稳定了。这个经验如果你只是做展示demo可能碰不到,但实际长期运行一定得考虑传感器的维护周期。
扩展空间也是这个项目的优势。华为云IoT的规则引擎可以把温度超限事件转发到SMN消息通知服务,直接发短信到手机,比让用户一直盯着App更主动。也可以再接一个OV2640摄像头,通过ESP-01S的分支或者再外挂一个ESP32-CAM,定时拍照上传OBS,就能在手机上看到鱼缸实时画面。软件端如果不想自己写App,可以用华为云IoT提供的业务对接API,做一个微信小程序或者换个轻量化的H5页面,这个阶段对提升整个项目的完整度帮助很大。
做这个项目最大的一个体会是:STM32端的代码在可维护性上的锻炼比“能不能跑通”更重要。如果一开始就把AT指令接收、解析、执行通过状态机拆开来,后面加任何功能都只需要适配一条新指令,而不是天天翻主线逻辑。网上现成的智能鱼缸方案很多,但能自己把硬件、协议、云端串起来并保持稳定,这才是做嵌入式项目真正珍贵的部分。
8815



被折叠的 条评论
为什么被折叠?



