基于STM32的智能水质检测鱼缸监测系统设计

摘要

随着水族观赏、水产养殖及水培农业产业的快速发展，水体环境的质量直接影响生物的生存状态与生长效率，传统水质监测方式存在操作繁琐、实时性差、无法远程管控等弊端，难以满足现代化水环境管理的需求。为解决上述问题，本文设计并实现了一套基于STM32F103C8T6单片机的多参数智能水质检测鱼缸监测系统，整合水质参数采集、本地显示、阈值报警、WiFi远程通信及物联网平台对接等核心功能，构建了一套性价比高、操作便捷、性能稳定的智能化水质监测解决方案。

系统以STM32F103C8T6单片机为核心控制单元，硬件上集成DS18B20温度传感器、TDS电导率传感器、PH酸碱度传感器、浊度传感器四大核心传感模块，搭配0.96寸OLED显示屏、独立按键、蜂鸣器及ESP8266 WiFi模块，实现多模块协同工作；软件上基于Keil MDK5开发环境，采用C语言编写程序，遵循模块化设计原则，开发各功能子程序，同时对接机智云物联网平台，实现WiFi远程通信、数据同步及远程监控功能。

本文详细阐述了系统的总体方案设计、硬件电路设计、软件程序开发、机智云平台对接、系统调试及性能测试过程。测试结果表明，该智能水质检测鱼缸监测系统各模块工作稳定，水温、TDS值、PH值、浊度四项关键水质参数采集精准，报警机制可靠，WiFi通信稳定，能够通过OLED显示屏实时显示监测数据，通过按键完成参数阈值设置，通过机智云APP实现远程实时查看，有效解决了传统水质监测的弊端，为水族观赏、水产养殖等领域提供了可靠的水质监测支持，具有良好的实际应用价值和推广前景。

关键词：STM32F103C8T6；智能水质监测；鱼缸监测；多传感器采集；ESP8266；机智云平台

资料内容

-》1 开发软件下载链接说明

-》3 程序 (文件夹及压缩包)

-》4 电路

-》7 图片

-》8 器件资料

-》9 ESP8266FLASH烧写工具

-》10 ESP8266固件

-》11 机智云APK

-》WiFi版水质检测元件清单.xls

第1章 绪论

1.1 研究意义

在现代社会，水族观赏已成为人们丰富精神生活的重要方式，水产养殖、水培农业更是关系到民生的重要产业，而水体环境的质量是决定这些领域健康发展的核心因素。水体的温度、TDS电导率、PH酸碱度、浊度等关键参数，直接影响水生生物的生存状态、生长速度及品质，一旦参数超出适宜范围，会导致水生生物出现应激反应、生病甚至死亡，给用户带来经济损失。

目前，传统的水质监测方式主要依赖人工采样、实验室检测，这种方式操作繁琐、耗时费力，无法实现实时监测，且检测结果存在滞后性，难以及时发现水质异常；部分简易监测设备仅能实现单一参数监测，功能单一，且无法实现远程管控，用户需要现场查看数据，使用便捷性差。因此，研发一套能够实时、精准监测多参数水质，且支持本地交互与远程管控的智能化监测系统，具有重要的现实意义。

基于STM32的智能水质检测鱼缸监测系统，通过多类传感器实时采集水体四项关键参数，实现数据的本地显示与远程同步，支持阈值设置与异常报警，能够让用户实时掌握水体环境状态，及时处理水质异常，减少人工干预，降低管理成本。从理论意义来看，本研究融合STM32嵌入式技术、传感器检测技术、WiFi通信技术及物联网技术，丰富了智能水质监测系统的设计思路和技术方案，为同类智能监测产品的研发提供了参考与借鉴。从实际意义来看，该系统成本低廉、安装便捷、操作简单，适配家庭鱼缸、小型水产养殖池、水培装置等多种场景，能够有效解决传统水质监测的痛点，推动水环境管理向智能化、远程化方向发展，具有良好的实用性和推广价值。

1.2 研究背景

当前，物联网、大数据、嵌入式技术的快速发展，推动各行各业向智能化、数字化转型，水质监测领域也不例外。随着人们生活水平的提高，对水族观赏的品质要求不断提升，对鱼缸水质的监测需求也日益迫切；同时，水产养殖行业为实现规模化、精细化管理，对水质实时监测的需求也不断增加，传统监测方式已难以满足行业发展需求。

我国高度重视水环境治理与监测技术的发展，出台了多项政策支持智能监测设备的研发和推广，鼓励利用物联网技术提升水环境管理水平。目前，市面上的智能水质监测设备种类繁多，但存在诸多不足：部分产品功能单一，仅支持单一参数监测，无法全面反映水体质量；部分产品价格昂贵，依赖高端芯片和复杂算法，难以普及到普通家庭和小型养殖用户；部分产品缺乏便捷的远程管控功能，用户无法随时随地掌握水质状态；还有部分产品操作复杂，兼容性差，系统稳定性有待提升。

STM32系列单片机凭借其高性能、低功耗、外设丰富、性价比高的优势，已广泛应用于各类嵌入式智能设备的开发。STM32F103C8T6单片机作为入门级嵌入式芯片，具备足够的运算能力和外设接口，能够满足智能水质监测系统的控制需求，同时成本较低、体积小巧，适合批量生产和推广。ESP8266 WiFi模块作为常用的物联网通信模块，具有通信稳定、功耗低、成本低廉、接线简单等优点，能够快速实现系统与物联网平台的无线通信，降低系统开发难度。机智云平台作为专业的物联网云平台，提供了便捷的设备接入、数据存储、远程查看等服务，能够快速实现智能设备的云端部署和远程管控。

在此背景下，设计一款基于STM32F103C8T6单片机的智能水质检测鱼缸监测系统，整合多参数监测、本地交互、远程管控、异常报警等功能，兼顾性价比和实用性，解决传统水质监测的弊端，满足普通家庭、小型养殖用户的智能化监测需求，具有重要的现实意义和应用价值。

1.3 国内外研究现状

随着智能监测技术的不断发展，国内外学者和企业对水质监测系统的研究和开发投入不断增加，形成了多种技术方案和产品形态，具体研究现状如下：

（1）国内研究现状：国内智能水质监测产业发展迅速，众多企业和科研机构纷纷开展智能水质监测系统的研发，产品性价比不断提升，功能日益丰富。目前，国内主流的智能水质监测系统主要集中在多参数监测、本地显示、异常报警等领域，大多采用STM32系列单片机作为核心控制单元，结合各类水质传感器和通信模块，实现水质参数的精准采集和数据传输。同时，国内学者在嵌入式智能水质监测系统研发方面取得了诸多成果，优化了传感器采集精度和数据处理算法，提升了系统的稳定性和实用性。但国内部分产品仍存在不足，如传感器监测精度有待提升、WiFi通信稳定性不足、与物联网平台的对接不够便捷、操作流程复杂等，难以完全满足普通用户的使用需求。

（2）国外研究现状：国外智能水质监测技术起步较早，技术相对成熟，产品的智能化程度和稳定性较高。国外产品不仅具备基础的多参数监测、异常报警功能，还融入了人工智能、大数据分析等先进技术，能够根据水质变化趋势进行预测，为用户提供精准的管理建议。例如，美国、日本等国家的智能水质监测设备，支持多参数精准监测、远程管控、数据趋势分析等高级功能，适配大型养殖基地、水环境治理等场景，极大提升了水环境管理效率。但此类产品价格昂贵，且部分功能与我国普通用户的使用习惯适配性较差，同时依赖特定的云平台和生态系统，难以在普通家庭和小型养殖用户中广泛普及。

1.4 研究内容与技术路线

1.4.1 研究内容：本文围绕基于STM32的智能水质检测鱼缸监测系统设计展开，主要研究内容如下：

1. 系统总体方案设计：结合鱼缸水质监测的需求和硬件特性，设计系统总体架构，划分功能模块，明确各模块的功能和交互逻辑，完成元器件选型，确保系统功能完整、性能稳定、性价比高，适配家庭鱼缸、小型养殖池等场景使用。

2. 硬件电路设计：基于STM32F103C8T6单片机，设计各功能模块的硬件电路，包括主控模块、传感器模块、执行设备模块、显示与输入模块、通信模块及电源模块，完成电路绘制和硬件组装。

3. 软件程序开发：基于Keil MDK5开发环境，采用C语言编写系统软件程序，搭建软件总体架构，开发主程序及各功能模块子程序，实现水质参数采集、数据处理、显示控制、报警控制、人机交互、WiFi通信等功能。

4. 机智云平台对接：完成ESP8266 WiFi模块与机智云平台的对接，实现设备注册、数据上传、远程查看等功能，调试机智云APP交互界面，实现远程水质监测。

5. 系统调试与性能测试：搭建测试环境，模拟鱼缸实际水环境，制定测试方案，对系统各模块进行单独测试和整机联调，排查故障并进行优化，验证系统的功能和性能，确保参数采集精度、报警可靠性、WiFi通信稳定性等指标达到设计要求。

6. 研究总结与展望：总结本研究的成果和不足，结合智能水质监测技术的发展趋势，对系统的后续优化方向进行展望。

1.4.2 技术路线：本文遵循“需求分析—方案设计—硬件开发—软件开发—云平台对接—调试优化—总结展望”的技术路线，具体如下：

1. 需求分析：明确智能水质检测鱼缸监测系统的核心功能需求和性能要求，梳理研究重点和难点，结合水生生物生长的适宜水质参数，确定系统的设计目标。

2. 方案设计：设计系统总体架构，划分功能模块，完成元器件选型，确定硬件连接方式和软件设计思路，绘制系统总体框图和各模块电路图。

3. 硬件开发：绘制各模块硬件电路图，完成硬件焊接、组装和接线，确保硬件系统正常工作，兼顾设备的小型化、防水性和抗干扰性，适配鱼缸潮湿环境。

4. 软件开发：编写系统软件程序，调试各功能模块子程序，实现各模块协同工作，优化程序代码，降低系统功耗，提升系统稳定性和响应速度，加入数据滤波和异常处理逻辑。

5. 云平台对接：配置机智云平台，完成ESP8266 WiFi模块与云平台的通信，调试APP交互功能，实现远程数据查看和参数同步。

6. 调试优化：对系统进行单元测试和整机联调，排查硬件故障和软件漏洞，优化参数采集精度和WiFi通信稳定性，确保系统满足实际使用需求。

7. 总结展望：总结研究成果，分析存在的不足，提出后续优化方向，为同类智能水质监测产品的研发提供参考。

第2章 系统方案设计

2.1 系统总体架构设计

本基于STM32的智能水质检测鱼缸监测系统采用模块化架构设计，以STM32F103C8T6单片机为核心控制单元，整合硬件层、软件层和云平台层三大层面，实现水质参数监测、本地显示、阈值报警、人机交互、WiFi远程通信及机智云平台管控等核心功能。系统总体架构分为核心控制模块、传感器模块、执行设备模块、显示与输入模块、通信模块及电源模块六大模块，各模块协同工作，确保系统稳定运行，适配家庭鱼缸、小型养殖池等实际使用场景。

系统总体架构设计遵循“模块化、低成本、易操作、高稳定、抗干扰”的原则，各模块功能划分清晰、接口标准化，便于后期调试、维护和升级，同时兼顾系统的实用性和性价比，适应鱼缸潮湿、多干扰的环境特点。具体模块功能如下：

1. 核心控制模块：以STM32F103C8T6单片机为核心，负责接收各模块的输入信号（传感器数据、按键指令、机智云平台指令等），进行数据处理和逻辑判断，向各输出模块下发控制指令，统筹协调各模块的工作，是系统的“大脑”；同时负责数据存储，记录水质参数的历史值、报警信息及设备运行状态。

2. 传感器模块：由DS18B20温度传感器、TDS电导率传感器、PH酸碱度传感器、浊度传感器组成，负责采集鱼缸水体的温度、TDS值、PH值、浊度四项关键参数，将采集到的数据传输至核心控制模块，为报警判断和数据展示提供数据依据。

3. 执行设备模块：由蜂鸣器组成，负责接收核心控制模块的控制指令，当水质参数超出预设阈值时，驱动蜂鸣器发出报警声，提醒用户及时处理水质异常，同时可配合指示灯实现声光报警，提升报警提示效果。

4. 显示与输入模块：由0.96寸OLED显示屏和独立按键组成，OLED显示屏负责实时显示各类水质参数、参数阈值、设备运行状态及报警信息，便于用户本地查看；独立按键负责接收用户的手动操作指令（界面切换、参数阈值设置、报警取消等），实现用户与系统的本地交互。

5. 通信模块：由USB接口和ESP8266 WiFi模块组成，USB接口用于STM32单片机与电脑的串口通信，实现程序下载和数据调试；ESP8266 WiFi模块用于实现系统与机智云平台的无线通信，将采集到的水质参数和设备状态上传至云平台，同时接收云平台下发的同步指令，实现远程数据查看。

6. 电源模块：负责为整个系统提供稳定的供电，将外部输入的电压转换为各模块所需的工作电压，确保各模块正常工作，同时实现电源保护和抗干扰设计，适应家庭供电环境。

系统工作流程如下：系统上电后，各模块初始化，传感器模块将探头放入水体中，开始实时采集水质参数；核心控制模块对采集到的数据进行处理、分析，与预设的水质参数阈值进行对比，判断是否需要触发报警；显示模块实时更新显示内容，包括各类参数、阈值和报警信息；当参数超出阈值时，核心控制模块下发控制指令，驱动蜂鸣器发声报警；通信模块将采集到的数据和设备状态上传至机智云平台，用户可通过机智云APP查看实时数据；用户也可通过本地按键切换界面、设置参数阈值、取消报警。

2.2 元器件选型

结合系统功能需求、鱼缸的环境特点、性能要求、性价比及易用性，严格筛选适配的元器件，确保各模块兼容、稳定工作，同时兼顾系统的低成本、小型化、防水性和抗干扰性，各模块元器件选型如下：

2.2.1 核心控制模块选型：选用STM32F103C8T6最小系统板作为核心控制单元。该芯片基于ARM Cortex-M3内核，主频最高可达72MHz，拥有64KB Flash存储器和20KB SRAM，可满足系统程序存储和数据处理需求，同时能够存储一定量的水质参数历史数据和报警记录；外设丰富，配备多个通用I/O口、UART串口、I2C接口、ADC接口等，便于与各模块连接；低功耗特性突出，支持睡眠模式、停机模式等多种低功耗模式，可有效降低系统能耗；同时，该芯片性价比高、体积小，便于硬件集成，符合智能水质检测鱼缸监测系统的小型化和低成本需求。

2.2.2 传感器模块选型：

（1）温度传感器：选用DS18B20防水温度传感器，工作电压为3.3V-5V，采用单总线通信协议，接线简单、占用I/O口少；测量范围为-55℃-125℃（精度±0.5℃），能够精准采集鱼缸水体温度，适配不同水温环境的监测；具备良好的防水性能，可直接放入水体中使用，抗干扰能力强，适合鱼缸潮湿环境使用。

（2）TDS电导率传感器：选用模拟量输出TDS电导率传感器，工作电压为5V，测量范围为0-1000ppm，精度高、响应速度快；能够实时采集水体的TDS值，反映水体中可溶性固体的含量，判断水体的纯净度和污染程度，为水质评估提供依据；具备防水性能，可直接放入水体中使用，结构简单、稳定性好，适合鱼缸水质监测场景。

（3）PH酸碱度传感器：选用模拟量输出PH酸碱度传感器，工作电压为5V，测量范围为0-14PH（精度±0.1PH），能够精准采集水体的PH值，反映水体的酸碱程度，适配水生生物生长的适宜PH范围监测；具备防水性能，可直接放入水体中使用，响应速度快、稳定性好，适合鱼缸水质监测。

（4）浊度传感器：选用模拟量输出浊度传感器，工作电压为5V，测量范围为0-200NTU，精度高、响应速度快；能够实时采集水体的浊度，反映水体的浑浊程度，判断水体中悬浮杂质的含量，为水质清洁度评估提供依据；具备防水性能，可直接放入水体中使用，结构简单、抗干扰能力强，适合鱼缸水质监测。

2.2.3 执行设备模块选型：选用有源蜂鸣器，工作电压为3.3V，通过GPIO口直接驱动，声音洪亮、响应灵敏；无需额外驱动电路，接线简单；当水质参数超出预设阈值时，由核心控制模块控制蜂鸣器发声，实现报警提醒功能；同时搭配一个LED指示灯，实现声光报警，提升报警提示效果；功耗低、成本低廉，适合鱼缸场景使用。

2.2.4 显示与输入模块选型：

（1）OLED显示屏：选用0.96寸4针IIC协议OLED显示屏，分辨率为128×64，工作电压为3.3V，采用I2C通信协议，接线简单、占用I/O口少；显示清晰、对比度高、功耗低，可实时显示各类水质参数、参数阈值、报警信息等；体积小、重量轻，便于集成到系统中，符合小型化需求，且具备一定的抗干扰能力，适合鱼缸环境使用。

（2）按键模块：选用3个独立贴片按键，分别实现界面切换、参数增加/减少、确认/取消功能，按键手感好、响应灵敏，配合软件消抖算法，避免误操作；按键体积小，通过GPIO口与STM32单片机连接，接线简单，便于集成，且防水性能较好，适应鱼缸潮湿环境。

2.2.5 通信模块选型：

（1）USB接口：选用USB转TTL模块，用于STM32单片机与电脑的串口通信，实现程序下载和数据调试；通信稳定、传输速度快，接线简单，便于系统开发和调试。

（2）WiFi模块：选用ESP8266-01S WiFi模块，工作电压为3.3V，采用UART串口通信，与STM32单片机连接简单；基于WiFi 802.11 b/g/n协议，通信稳定、传输距离远（空旷环境下可达10米），可实现系统与机智云平台的无线通信；体积小、功耗低、成本低廉，是智能设备中常用的WiFi通信模块，且具备一定的抗干扰能力，适合家庭鱼缸场景使用。

2.2.6 电源模块选型：选用5V、1A直流电源适配器作为系统供电电源，为STM32单片机、各传感器、蜂鸣器、LED指示灯等模块提供稳定供电；配备AMS1117-3.3V稳压芯片，将5V电压转换为3.3V，为STM32单片机、OLED显示屏、ESP8266 WiFi模块等需要3.3V供电的模块提供稳定电压；同时加入电源开关、保险丝和滤波电路，电源开关用于开启和关闭系统，保险丝用于过流保护，滤波电路用于减少电源噪声，提升系统稳定性，适应家庭供电环境。

第3章 硬件电路设计

3.1 系统硬件总体结构

系统硬件总体结构以STM32F103C8T6最小系统板为核心，整合传感器模块、执行设备模块、显示与输入模块、通信模块及电源模块，各模块通过相应的接口与核心控制单元连接，实现数据传输与指令交互。硬件总体结构清晰、布局合理，兼顾低成本、小型化、防水性和抗干扰性，便于焊接、调试与维护，适配家庭鱼缸潮湿、多干扰的安装使用场景。

系统硬件总体连接关系如下：STM32F103C8T6单片机通过单总线接口连接DS18B20温度传感器；通过ADC接口连接TDS电导率传感器、PH酸碱度传感器、浊度传感器；通过GPIO口连接蜂鸣器、LED指示灯和3个独立按键；通过I2C接口连接OLED显示屏；通过UART串口连接ESP8266-01S WiFi模块和USB转TTL模块；电源模块为所有模块提供稳定供电，确保各模块正常工作。

硬件电路设计的核心目标是：确保各模块接线合理、兼容性良好，降低成本、提升稳定性和抗干扰性，避免信号干扰和环境因素对系统的影响，同时兼顾硬件的小型化和易用性，适配家庭鱼缸的安装使用需求。本章将详细阐述各模块的电路设计原理、接线方式及关键技术要点。

3.2 主控模块设计

主控模块以STM32F103C8T6最小系统板为核心，是整个系统的控制中心，负责接收各模块的输入信号、进行数据处理与逻辑判断、下发控制指令，统筹协调各模块的工作，同时负责数据存储和系统低功耗控制。STM32F103C8T6最小系统板已集成电源接口、复位电路、晶振电路、下载接口等基础电路，无需额外设计，可直接使用，有效简化电路设计、减小硬件体积。

3.2.1 最小系统板电路设计：STM32F103C8T6最小系统板主要包括电源电路、晶振电路、复位电路、下载接口电路四部分。电源电路采用5V供电，通过AMS1117-3.3V稳压芯片将5V电压转换为3.3V，为单片机核心供电；晶振电路采用8MHz外部晶振，配合两个22pF电容，为单片机提供稳定的时钟信号，确保程序正常运行；复位电路采用上电复位与手动复位相结合的方式，通过一个10KΩ电阻和一个100nF电容组成上电复位电路，同时配备一个手动复位按键，便于系统复位重启；下载接口采用SWD下载模式，通过PA13（SWDIO）和PA14（SWCLK）两个引脚实现程序下载与在线调试，接线简单、下载速度快。

3.2.2 主控模块接口分配：为确保各模块正常工作，合理分配STM32F103C8T6的I/O口和外设接口，具体接口分配如下（核心接口）：

1. 单总线接口：PB0连接DS18B20温度传感器；

2. ADC接口：PA0连接TDS电导率传感器，PA1连接PH酸碱度传感器，PA2连接浊度传感器；

3. GPIO口：PB1连接蜂鸣器，PB2连接LED指示灯，PB3-PB5连接3个独立按键（界面切换、参数增加/减少、确认/取消）；

4. I2C接口：PB14（I2C2_SCL）、PB15（I2C2_SDA），连接OLED显示屏；

5. UART串口：USART1（PA9-TX、PA10-RX）连接ESP8266-01S WiFi模块，USART2（PA2-TX、PA3-RX）连接USB转TTL模块；

6. 电源接口：VCC（5V、3.3V）、GND，连接电源模块，为单片机供电。

3.2.3 抗干扰与低功耗设计：考虑到鱼缸环境潮湿、干扰较多，在电路设计中加入抗干扰措施：在单片机电源引脚与GND之间并联一个100nF电容，用于滤波，减少电源噪声；在晶振电路的电容两端并联一个1MΩ电阻，确保晶振稳定振荡；各I/O口与外设连接时，串联一个1KΩ限流电阻，防止电流过大损坏单片机引脚；模拟信号接口（ADC接口）与数字信号接口分开布置，避免信号干扰，提升参数采集精度；传感器的接线采用屏蔽线，减少外部干扰。

为降低系统能耗，加入低功耗控制设计：当系统长时间无操作且参数正常时，控制各模块进入低功耗模式，关闭OLED显示屏背光，降低传感器和WiFi模块的功耗；当检测到按键操作、参数异常或云平台指令时，唤醒系统，恢复正常工作模式，节约电力资源。

3.3 传感器模块设计

传感器模块负责采集鱼缸水体的温度、TDS值、PH值、浊度四项关键参数，为系统的报警判断和数据展示提供数据依据，由DS18B20、TDS电导率、PH酸碱度、浊度传感器组成，各模块电路设计独立，接口标准化，便于调试和维护，同时兼顾防水性和抗干扰性，适配鱼缸潮湿环境。

3.3.1 DS18B20温度传感器电路设计：DS18B20传感器采用单总线通信协议，与STM32单片机的GPIO口连接，电路设计如下：传感器的VCC引脚接5V电源，GND引脚接地，DQ引脚（数据引脚）接STM32的PB0引脚；为了确保通信稳定，在DQ引脚与VCC引脚之间串联一个4.7KΩ的上拉电阻，避免信号波动；同时，在传感器的VCC和GND引脚之间并联一个100nF的电容，用于滤波，减少电源噪声对测量结果的影响；传感器采用防水封装，可直接放入鱼缸水体中，用于采集水体温度数据。

DS18B20传感器的工作原理：传感器内部集成了温度采集电路和A/D转换电路，能够将采集到的水体温度信号转换为数字信号；单片机通过单总线接口向传感器发送指令，控制传感器进行温度采集，采集完成后，传感器将数字温度信号反馈给单片机，单片机对数据进行处理，得到当前水体温度值，测量精度高，适配鱼缸水温监测。

3.3.2 TDS电导率传感器电路设计：TDS电导率传感器通过ADC接口输出模拟信号，与STM32单片机的ADC接口连接，电路设计如下：传感器的VCC引脚接5V电源，GND引脚接地，AO引脚（模拟输出引脚）接STM32的PA0引脚；为了确保数据采集的稳定性，在传感器的VCC和GND引脚之间并联一个100nF的电容，用于滤波，减少电源噪声对测量结果的干扰；同时，在AO引脚与GND之间并联一个10KΩ的电阻，用于稳定模拟信号；传感器探头采用防水设计，可直接放入鱼缸水体中，用于采集水体TDS值。

TDS电导率传感器的工作原理：传感器内部的电极在接触到水体时，会根据水体中可溶性固体的含量产生不同的电导信号，通过电路转换为模拟电压信号；单片机通过ADC接口读取模拟电压信号，经过A/D转换和算法处理，将电压信号转换为对应的TDS值，能够准确反映水体的纯净度和污染程度，为水质评估提供依据。

3.3.3 PH酸碱度传感器电路设计：PH酸碱度传感器通过ADC接口输出模拟信号，与STM32单片机的ADC接口连接，电路设计如下：传感器的VCC引脚接5V电源，GND引脚接地，AO引脚（模拟输出引脚）接STM32的PA1引脚；为了确保数据采集的稳定性，在传感器的VCC和GND引脚之间并联一个100nF的电容，用于滤波，减少电源噪声对测量结果的干扰；同时，在AO引脚与GND之间并联一个10KΩ的电阻，用于稳定模拟信号；传感器探头采用防水设计，可直接放入鱼缸水体中，用于采集水体PH值。

PH酸碱度传感器的工作原理：传感器内部的PH敏感元件在接触到水体时，会根据水体的酸碱程度产生不同的电位差，通过电路转换为模拟电压信号；单片机通过ADC接口读取模拟电压信号，经过A/D转换和算法处理，将电压信号转换为对应的PH值，能够准确反映水体的酸碱程度，适配水生生物生长的适宜PH范围监测。

3.3.4 浊度传感器电路设计：浊度传感器通过ADC接口输出模拟信号，与STM32单片机的ADC接口连接，电路设计如下：传感器的VCC引脚接5V电源，GND引脚接地，AO引脚（模拟输出引脚）接STM32的PA2引脚；为了确保数据采集的稳定性，在传感器的VCC和GND引脚之间并联一个100nF的电容，用于滤波，减少电源噪声对测量结果的干扰；同时，在AO引脚与GND之间并联一个10KΩ的电阻，用于稳定模拟信号；传感器探头采用防水设计，可直接放入鱼缸水体中，用于采集水体浊度。

浊度传感器的工作原理：传感器内部的红外发射管发射红外光，当光线穿过水体时，水体中的悬浮杂质会对光线进行散射和吸收，红外接收管接收散射后的光线并转换为模拟电压信号；单片机通过ADC接口读取模拟电压信号，经过A/D转换和算法处理，将电压信号转换为对应的浊度值，能够准确反映水体的浑浊程度，为水质清洁度评估提供依据。

3.4 执行设备模块设计

执行设备模块负责接收核心控制模块的控制指令，实现异常情况下的声光报警，由蜂鸣器和LED指示灯组成，电路设计简单、稳定性好、安全性高，适配家庭鱼缸的使用场景。

3.4.1 蜂鸣器电路设计：有源蜂鸣器通过GPIO口直接由STM32单片机驱动，电路设计如下：蜂鸣器的VCC引脚接3.3V电源，GND引脚通过1KΩ限流电阻连接STM32的PB1引脚；当PB1引脚输出低电平时，蜂鸣器发声；当PB1引脚输出高电平时，蜂鸣器停止发声；限流电阻用于限制电流，防止电流过大损坏蜂鸣器和单片机引脚；同时，在蜂鸣器的VCC和GND引脚之间并联一个100nF的电容，用于滤波，减少电源噪声对蜂鸣器的影响；当水质参数超出预设阈值时，蜂鸣器触发报警，提醒用户及时处理。

3.4.2 LED指示灯电路设计：LED指示灯用于配合蜂鸣器实现声光报警，电路设计如下：LED指示灯的阳极通过1KΩ限流电阻连接STM32的PB2引脚，阴极接地；当PB2引脚输出高电平时，指示灯点亮；当PB2引脚输出低电平时，指示灯熄灭；限流电阻用于限制电流，防止电流过大损坏LED灯和单片机引脚；当蜂鸣器发声报警时，指示灯同步点亮，提升报警提示效果，便于用户快速发现水质异常。

3.5 显示与输入模块设计

显示与输入模块负责实时显示各类水质参数、参数阈值、报警信息，接收用户的手动操作指令，实现人机交互，由0.96寸OLED显示屏和3个独立按键组成，电路设计简单、操作便捷、稳定性好，适配家庭鱼缸的使用场景。

3.5.1 OLED显示屏电路设计：OLED显示屏采用I2C通信协议，与STM32单片机的I2C接口连接，电路设计如下：显示屏的VCC引脚接3.3V电源，GND引脚接地，SCL引脚接STM32的PB14引脚（I2C2_SCL），SDA引脚接STM32的PB15引脚（I2C2_SDA）；为了确保显示稳定，在显示屏的VCC和GND引脚之间并联一个100nF的电容，用于滤波，减少电源噪声对显示效果的影响；同时，显示屏的接线尽量缩短，避免信号干扰，确保显示清晰、无卡顿；显示屏的背光可通过单片机控制，低功耗模式下关闭背光，降低能耗。

3.5.2 显示内容设计：采用多级菜单显示系统，通过按键切换不同页面，各页面显示内容如下：

1. 主页面：显示当前水体温度、TDS值、PH值、浊度，以及各参数的预设阈值，便于用户快速查看核心信息；

2. 参数设置页面：可设置各水质参数的上下限阈值（温度、TDS值、PH值、浊度），通过按键调整阈值大小并确认保存；

3. 报警提示页面：当参数超出阈值时，自动切换至该页面，闪烁显示报警类型和相关参数，同时触发蜂鸣器和指示灯报警；

4. 历史数据页面：显示最近一段时间的参数采集记录，便于用户查看水质变化趋势。

显示更新频率为500ms，实时更新各项数据和工作状态，确保用户能够及时了解系统运行情况和鱼缸水质状态；当出现报警时，显示屏背光自动开启（若处于低功耗模式），闪烁显示报警信息，提升报警提示效果。

3.5.3 按键模块电路设计：3个独立按键分别对应界面切换、参数增加/减少、确认/取消功能，电路设计如下：3个按键的一端分别接STM32的PB3-PB5引脚，另一端均接地；为了防止按键抖动，在每个按键的GPIO口端与VCC引脚之间串联一个10KΩ的上拉电阻，同时在按键两端并联一个100nF的电容，用于硬件消抖；此外，通过软件消抖算法（延时10ms判断按键状态），进一步提升按键输入的稳定性，避免误操作；按键采用防水贴片设计，适应鱼缸潮湿环境。

3.5.4 按键功能说明：

1. PB3按键（界面切换）：短按一次，切换系统显示页面（主页面→参数设置页面→历史数据页面→主页面循环）；在报警状态下，短按一次取消当前报警；

2. PB4按键（参数增加/减少）：仅在参数设置页面有效，短按一次，增加当前选中参数的阈值；长按（超过500ms），减少当前选中参数的阈值；

3. PB5按键（确认/取消）：在参数设置页面，短按一次确认当前参数设置；短按两次取消当前参数设置，返回上一级页面；在主页面，长按（超过500ms）进入系统设置模式。

3.6 通信模块设计

通信模块负责实现系统与电脑的串口通信（程序下载、数据调试）和与机智云平台的无线通信（远程数据查看），由USB转TTL模块和ESP8266-01S WiFi模块组成，电路设计简单、通信稳定、抗干扰性强，适配家庭鱼缸的使用场景。

3.6.1 USB转TTL模块电路设计：USB转TTL模块用于STM32单片机与电脑的串口通信，电路设计如下：模块的VCC引脚接5V电源，GND引脚接地，TXD引脚（发送引脚）接STM32的PA3引脚（USART2_RX），RXD引脚（接收引脚）接STM32的PA2引脚（USART2_TX）；模块的USB接口连接电脑，实现程序下载和数据调试；为了确保通信稳定，在模块的VCC和GND引脚之间并联一个100nF的电容，用于滤波，减少电源噪声对通信的影响。

3.6.2 ESP8266 WiFi模块电路设计：ESP8266-01S WiFi模块采用UART串口通信，与STM32单片机的USART1接口连接，电路设计如下：模块的VCC引脚接3.3V电源，GND引脚接地，TXD引脚（发送引脚）接STM32的PA10引脚（USART1_RX），RXD引脚（接收引脚）接STM32的PA9引脚（USART1_TX）；为了确保通信稳定，在模块的VCC和GND引脚之间并联一个100nF的电容，用于滤波，减少电源噪声对通信的影响；同时，在模块与单片机之间串联1KΩ限流电阻，防止电流过大损坏模块和单片机引脚；模块的CH_PD引脚接VCC引脚，确保模块正常工作；模块的GPIO0引脚接地，用于进入烧录模式（仅在烧录程序时使用）；模块安装在远离鱼缸水体的位置，确保WiFi信号稳定，同时避免受潮损坏。

3.6.3 通信协议设计：

1. 串口通信协议：采用标准UART串口通信协议，波特率设置为9600bps，数据位8位，停止位1位，校验位无，实现STM32单片机与电脑、ESP8266 WiFi模块的数据交互；

2. WiFi通信协议：采用机智云平台规定的串口通信协议，实现系统与机智云平台的数据双向传输，主要分为数据上传和指令同步两部分：

（1）数据上传：STM32单片机将采集到的水体温度、TDS值、PH值、浊度等参数，以及设备运行状态和报警信息，按照机智云协议格式打包，通过UART串口发送给ESP8266模块，ESP8266模块将数据通过WiFi上传至机智云平台；

（2）指令同步：用户通过机智云APP查看数据时，云平台将同步指令发送给ESP8266模块，ESP8266模块通过UART串口将指令转发给STM32单片机，单片机解析指令后，将最新的水质参数上传至云平台，实现数据实时同步。

3.7 电源模块设计

电源模块负责为整个系统提供稳定的供电，确保各模块正常工作，同时实现电源保护和抗干扰设计，适应家庭供电环境，由5V直流电源适配器、AMS1117-3.3V稳压芯片和相关滤波电路组成。

3.7.1 电路设计原理：5V直流电源适配器作为系统的供电电源，输出5V电压，为TDS电导率传感器、PH酸碱度传感器、浊度传感器、蜂鸣器、LED指示灯等需要5V供电的模块提供直接供电；同时，5V电压通过AMS1117-3.3V稳压芯片转换为3.3V，为STM32单片机、OLED显示屏、ESP8266 WiFi模块、DS18B20温度传感器等需要3.3V供电的模块提供稳定供电；在稳压芯片的输入端和输出端分别并联一个100nF的电容，用于滤波，减少电源噪声；同时，加入电源开关、保险丝和1000μF电解电容，电源开关用于开启和关闭系统，保险丝用于过流保护，防止电流过大损坏电路，电解电容用于稳定电压，减少电压波动。

3.7.2 电源稳定性设计：为提升电源模块的稳定性，避免电压波动和外部干扰对系统的影响，电源线采用屏蔽线，减少外部干扰；各模块的电源接口处均并联100nF电容，用于滤波，确保各模块获得稳定的供电；同时，电源模块远离鱼缸水体，避免受潮损坏，远离传感器和执行设备，避免电磁干扰，提升系统整体稳定性；考虑到家庭供电可能出现的电压不稳定情况，在电源适配器输入端加入浪涌保护电路，防止电压突变损坏系统。

第4章 软件设计

4.1 软件总体架构与主程序设计

4.1.1 软件总体架构：本系统软件基于Keil MDK5开发环境，采用C语言编写，遵循“模块化设计”原则，将软件划分为主程序模块、传感器模块程序、执行设备模块程序、显示模块程序、人机交互模块程序、通信模块程序、机智云对接模块程序及数据存储模块程序八大模块，各模块独立编写、相互调用，确保软件结构清晰、易于调试、便于维护和升级。

软件总体架构分为三层：底层驱动层、核心功能层、应用层。底层驱动层负责各硬件模块的驱动，包括STM32单片机外设驱动（GPIO、ADC、I2C、UART等）、传感器驱动（DS18B20、TDS电导率、PH酸碱度、浊度传感器）、OLED显示驱动、蜂鸣器驱动、ESP8266 WiFi驱动等，为上层功能实现提供支撑；核心功能层负责实现系统的核心功能，包括参数采集与处理、报警控制、显示控制、人机交互、WiFi通信、机智云对接、数据存储与查询等；应用层负责统筹协调各核心功能模块的工作，实现系统的整体运行逻辑，响应用户操作和云平台指令，确保各功能协同工作。

4.1.2 主程序设计：主程序是系统软件的核心，负责系统初始化、各模块调用、逻辑判断和整体控制，主程序流程如下：

1. 系统上电后，首先进行初始化操作，包括STM32单片机初始化（时钟、I/O口、ADC、I2C、UART等外设初始化）、各模块初始化（传感器模块初始化、执行设备模块初始化、显示模块初始化、按键模块初始化、通信模块初始化、机智云对接初始化、数据存储模块初始化）；

2. 初始化完成后，系统默认进入主页面，OLED显示屏显示各类水质参数和参数阈值，各传感器开始实时采集数据，ESP8266模块连接家庭WiFi并接入机智云平台；

3. 进入主循环，依次调用各功能模块：传感器模块采集各类水质参数，进行数据处理和滤波；核心控制模块将采集到的参数与预设阈值进行对比，判断是否需要触发报警；执行设备模块根据控制指令运行（报警或正常状态）；显示模块实时更新显示内容；人机交互模块检测用户按键操作，执行相应指令；通信模块将数据和设备状态上传至机智云平台，同时接收云平台下发的同步指令，执行相应操作；数据存储模块存储实时数据和报警信息；

4. 加入异常处理逻辑，当检测到模块故障（如传感器采集失败、WiFi连接异常）时，及时在OLED显示屏显示故障提示，并尝试重新初始化模块，保障系统稳定运行；

5. 循环执行上述步骤，确保系统实时监测、精准报警、稳定通信，同时优化程序代码，降低系统功耗，提升系统响应速度。

主程序采用无限循环结构，通过延时函数和中断函数结合的方式，确保各模块的实时响应，避免程序卡顿；同时，加入软件消抖、数据滤波等算法，提升系统的稳定性和参数采集精度。

4.2 传感器模块程序设计

传感器模块程序负责控制各类传感器采集鱼缸水体的温度、TDS值、PH值、浊度四项关键参数，对数据进行处理、滤波和校准，为核心控制模块、显示模块和报警模块提供数据依据，同时将数据传输至主程序，用于机智云平台上传和数据存储，程序分为各传感器驱动程序和数据处理程序两部分。

4.2.1 DS18B20温度传感器程序设计：DS18B20传感器采用单总线通信协议，程序主要实现传感器初始化、温度采集、数据解析等功能。首先，单片机通过GPIO口向传感器发送复位脉冲，等待传感器的应答脉冲，完成传感器初始化；初始化成功后，发送温度采集指令，传感器开始采集水体温度并将数据存储在内部寄存器中；单片机读取传感器内部的温度数据（16位二进制数据），通过算法将二进制数据转换为十进制温度值，同时进行数据滤波处理，去除异常值，确保温度数据的准确性；最后，将处理后的温度数据传输至主程序，用于显示和报警判断。

为提升温度采集的精度和稳定性，程序中加入了多次采集取平均值的滤波算法，每次采集3组数据，去除最大值和最小值后取平均值，减少测量误差；同时，加入传感器故障检测逻辑，当连续3次采集失败时，判定为传感器故障，在OLED显示屏显示故障提示，并尝试重新初始化传感器。

4.2.2 TDS电导率传感器程序设计：TDS电导率传感器输出模拟信号，程序主要实现模拟信号采集、A/D转换、数据校准和转换等功能。首先，初始化STM32的ADC外设，设置ADC采样模式、采样周期等参数；通过ADC接口读取传感器输出的模拟电压信号，进行A/D转换，将模拟信号转换为数字信号（0-4095）；根据传感器的校准参数，通过算法将数字信号转换为对应的TDS值（ppm），同时进行数据滤波处理，去除异常值；最后，将处理后的TDS值传输至主程序，用于显示和报警判断。

程序中加入了线性校准算法，根据传感器的量程和输出特性，对采集到的数据进行校准，提升TDS值的测量精度；同时，加入数据滤波算法，采用滑动平均滤波法，取最近5组采集数据的平均值，减少信号波动对测量结果的影响。

4.2.3 PH酸碱度传感器程序设计：PH酸碱度传感器输出模拟信号，程序主要实现模拟信号采集、A/D转换、数据校准和转换等功能。首先，初始化STM32的ADC外设，设置采样参数；通过ADC接口读取传感器输出的模拟电压信号，进行A/D转换，将模拟信号转换为数字信号；根据传感器的校准参数（如PH=7时的电压值），通过算法将数字信号转换为对应的PH值（0-14），同时进行数据滤波处理；最后，将处理后的PH值传输至主程序，用于显示和报警判断。

程序中加入了两点校准算法，分别校准PH=4和PH=7时的电压值，提升PH值的测量精度；同时，加入异常值检测逻辑，当采集到的PH值超出0-14的合理范围时，判定为异常数据，舍弃该数据并重新采集，确保数据的准确性。

4.2.4 浊度传感器程序设计：浊度传感器输出模拟信号，程序主要实现模拟信号采集、A/D转换、数据校准和转换等功能。首先，初始化STM32的ADC外设，设置采样参数；通过ADC接口读取传感器输出的模拟电压信号，进行A/D转换，将模拟信号转换为数字信号；根据传感器的量程和输出特性，通过算法将数字信号转换为对应的浊度值（NTU），同时进行数据滤波处理；最后，将处理后的浊度值传输至主程序，用于显示和报警判断。

程序中加入了数据滤波算法，采用滑动平均滤波法，减少信号波动对测量结果的影响；同时，加入传感器故障检测逻辑，当连续3次采集到的浊度值超出合理范围时，判定为传感器故障，在OLED显示屏显示故障提示，并尝试重新初始化传感器。

4.2.5 传感器数据处理程序：数据处理程序负责对各传感器采集到的原始数据进行统一处理，包括滤波、校准、异常检测等，确保数据的准确性和稳定性。程序采用模块化设计，将不同传感器的数据处理逻辑封装为独立的函数，便于调用和维护；同时，设置数据缓存区，存储最近一段时间的采集数据，用于历史数据查询和趋势分析；当检测到异常数据时，及时舍弃并重新采集，确保传输至主程序的数据准确可靠。

4.3 执行设备模块程序设计

执行设备模块程序负责接收主程序的控制指令，驱动蜂鸣器和LED指示灯工作，实现异常情况下的声光报警，程序分为蜂鸣器驱动程序和LED指示灯驱动程序两部分，采用模块化设计，便于调用和维护。

4.3.1 蜂鸣器驱动程序：蜂鸣器驱动程序通过控制STM32的