【STM32物联网实战】基于机智云平台的智能水质监测系统设计与实现

1. 项目背景与意义

水质安全一直是环境保护和健康生活的重要议题。无论是家庭饮用水、水产养殖还是农业灌溉，水质的好坏都直接影响着我们的生活和生产。传统的水质检测方法往往需要人工采样后送到实验室分析，过程繁琐且无法实时监控。现在通过STM32单片机和物联网技术，我们可以轻松构建一个智能水质监测系统，实时采集水质数据并通过手机APP远程查看，让水质管理变得简单高效。

这个项目特别适合电子爱好者、物联网初学者以及需要水质监测的农业和水产养殖用户。不需要深厚的电子背景，只要跟着我的步骤，你也能快速搭建一套属于自己的智能水质监测系统。我实际测试过这个方案，成本低、稳定性好，非常适合个人和小型项目使用。

2. 系统架构设计

整个系统由三大部分组成：数据采集层、核心控制层和云平台层。数据采集层负责获取水质的各项参数，包括温度、PH值和浊度；核心控制层使用STM32单片机处理传感器数据；云平台层通过ESP8266模块将数据上传到机智云平台，实现手机APP的远程监控。

硬件架构框图：

传感器层 → STM32主控 → ESP8266模块 → 机智云平台 → 手机APP

传感器选型说明：

• DS18B20温度传感器：数字输出，精度0.5℃，直接输出温度值，无需复杂校准
• PH传感器：模拟输出，需要ADC转换，测量范围0-14PH
• TDS浊度传感器：模拟输出，反映水中悬浮颗粒物含量

我选择STM32F103C8T6作为主控芯片，因为它价格便宜（约10元）、资源丰富（72MHz主频、12位ADC、多个定时器），完全能满足这个项目的需求。ESP8266-01S模块负责网络连接，价格不到10元，AT指令操作简单，非常适合物联网项目。

3. 硬件设计与连接

3.1 元器件清单

元器件名称	型号规格	数量	备注
主控芯片	STM32F103C8T6	1	最小系统板即可
WiFi模块	ESP8266-01S	1	支持AT指令
温度传感器	DS18B20	1	防水型
PH传感器	模拟输出型	1	带电极探头
浊度传感器	TDS-300B	1	模拟输出
OLED屏幕	0.96寸I2C	1	显示实时数据
按键	轻触开关	4	参数设置用
蜂鸣器	有源5V	1	报警提示

3.2 硬件连接详解

电源部分： 整个系统采用5V供电，通过USB接口或者锂电池供电。STM32的3.3V稳压芯片为单片机和其他模块提供稳定电压。在实际接线时，一定要确保电源稳定，我在测试过程中就遇到过因为电源波动导致传感器读数不准的情况。

传感器接线：

// DS18B20接线
DQ → PC6    // 单总线数据线
VCC → 3.3V
GND → GND

// PH传感器接线
AO → PA0    // 连接到ADC1通道0
VCC → 3.3V
GND → GND

// 浊度传感器接线
AO → PA1    // 连接到ADC1通道1
VCC → 3.3V
GND → GND

ESP8266连接：

ESP8266_TX → PA2    // 连接到STM32的USART2_RX
ESP8266_RX → PA3    // 连接到STM32的USART2_TX
ESP8266_VCC → 3.3V
ESP8266_GND → GND

注意：ESP8266模块的电源一定要稳定，最好单独用一颗稳压芯片供电。我在初期测试时因为电源问题导致模块频繁重启，后来单独给ESP8266供电后就稳定了。

4. 传感器数据采集与处理

4.1 温度传感器读取

DS18B20是单总线数字温度传感器，读取相对简单。需要先初始化总线，然后发送转换命令，最后读取温度值。我封装了一个读取函数：

float DS18B20_ReadTemp(void)
{
    uint8_t temp[2];
    DS18B20_Start();            // 启动转换
    DelayMs(750);               // 等待转换完成
    DS18B20_ReadBytes(temp, 2); // 读取温度值
    
    int16_t raw_temp = (temp[1] << 8) | temp[0];
    return raw_temp * 0.0625;   // 转换为摄氏度
}

在实际使用中，我发现DS18B20的读数偶尔会跳变，所以增加了软件滤波：

#define TEMP_FILTER_SIZE 5
float temperature_filter[TEMP_FILTER_SIZE];

float Filter_Temperature(float new_temp)
{
    static uint8_t index = 0;
    temperature_filter[index] = new_temp;
    index = (index + 1) % TEMP_FILTER_SIZE;
    
    float sum = 0;
    for(uint8_t i=0; i<TEMP_FILTER_SIZE; i++){
        sum += temperature_filter[i];
    }
    return sum / TEMP_FILTER_SIZE;
}

4.2 PH值传感器校准

PH传感器的读数需要校准才能准确。我采用两点校准法，使用PH4.0和PH7.0的标准缓冲液：

// 在标准缓冲液中读取ADC值
#define PH4_ADC_VALUE  1500    // 在PH4.0缓冲液中读取的ADC值
#define PH7_ADC_VALUE  2000    // 在PH7.0缓冲液中读取的ADC值

float Read_PH_Value(uint16_t adc_value)
{
    // 计算斜率k和截距b
    float k = 3.0 / (PH7_ADC_VALUE - PH4_ADC_VALUE);
    float b = 7.0 - k * PH7_ADC_VALUE;
    
    float voltage = adc_value * 3.3 / 4096;  // STM32的ADC是12位
    return k * voltage + b;
}

在实际使用中，PH传感器需要定期校准（建议每月一次），而且电极要保持清洁，否则读数会漂移。我遇到过因为电极脏污导致读数偏差2个PH值的情况，清洗后恢复正常。

4.3 浊度传感器处理

浊度传感器的输出是非线性的，需要分段处理：

float Read_Turbidity(uint16_t adc_value)
{
    float voltage = adc_value * 3.3 / 4096;
    
    // 根据实测数据分段处理
    if(voltage < 1.0) {
        return 0;  // 清澈
    }
    else if(voltage < 2.0) {
        return (voltage - 1.0) * 50;  // 轻度浑浊
    }
    else {
        return 50 + (voltage - 2.0) * 25;  // 重度浑浊
    }
}

浊度传感器在使用时要注意避免气泡干扰，我在鱼缸中测试时发现，如果有气泡附着在传感器表面，读数会突然升高。解决方法是在传感器周围加一个小型防泡罩。

5. 机智云平台接入

5.1 平台配置步骤

首先需要在机智云官网注册账号并创建产品：

1. 登录机智云开发者中心
2. 点击"创建新产品"，选择"智能家居"类别
3. 定义数据点：温度（数值型）、PH值（数值型）、浊度（数值型）
4. 生成产品标识码（PK）和产品密钥（PS）

数据点定义示例：

{
    "data_points": [
        {
            "name": "temperature",
            "type": "value",
            "min": 0,
            "max": 100,
            "unit": "℃"
        },
        {
            "name": "ph_value", 
            "type": "value",
            "min": 0,
            "max": 14,
            "unit": "PH"
        }
    ]
}

5.2 ESP8266通信配置

ESP8266通过AT指令配置为STA模式，连接路由器：

void ESP8266_Init(void)
{
    // 重启模块
    USART2_SendString("AT+RST\r\n");
    DelayMs(1000);
    
    // 设置模式
    USART2_SendString("AT+CWMODE=1\r\n");
    DelayMs(500);
    
    // 连接WiFi
    USART2_SendString("AT+CWJAP=\"你的WiFi名\",\"你的密码\"\r\n");
    DelayMs(3000);
    
    // 连接机智云服务器
    USART2_SendString("AT+CIPSTART=\"TCP\",\"183.230.40.39\",80\r\n");
    DelayMs(1000);
}

在实际测试中，我发现ESP8266的连接稳定性很重要。建议增加重连机制：

void Check_WIFI_Connection(void)
{
    static uint32_t last_check = 0;
    if(HAL_GetTick() - last_check > 10000){ // 每10秒检查一次
        USART2_SendString("AT+CIPSTATUS\r\n");
        // 解析返回状态，如果断开就重新连接
        last_check = HAL_GetTick();
    }
}

5.3 数据上传协议

机智云使用特定的JSON格式上传数据：

void Gizwits_UploadData(float temp, float ph, float turbidity)
{
    char buffer[128];
    sprintf(buffer, "{\"temperature\":%.1f,\"ph_value\":%.1f,\"turbidity\":%.1f}",
            temp, ph, turbidity);
    
    char cmd[64];
    sprintf(cmd, "AT+CIPSEND=%d\r\n", strlen(buffer));
    
    USART2_SendString(cmd);
    DelayMs(100);
    USART2_SendString(buffer);
}

数据上传频率要适中，太频繁会浪费流量，太慢会失去实时性。我设置的是每30秒上传一次数据，异常时立即上传。

6. 手机APP监控界面

机智云提供了自动生成的APP，也可以自定义开发。我建议先用自动生成的APP快速验证功能，后期再考虑自定义开发。

APP主要功能：

• 实时显示水质参数
• 设置报警阈值
• 历史数据查询
• 异常报警推送

在APP设计中，我发现用户体验很重要。比如：

• 用颜色区分正常和异常状态（绿色正常，红色异常）
• 设置合理的默认阈值（PH值6.5-8.5，浊度小于50NTU）
• 提供一键校准功能

报警推送功能很实用，当水质异常时，手机会立即收到通知。我在测试时故意让PH值超标，手机马上收到报警，响应很快。

7. 软件程序设计

7.1 主程序框架

程序采用前后台架构，主循环处理主要任务，中断处理紧急事件：

int main(void)
{
    System_Init();          // 系统初始化
    Gizwits_Init();         // 机智云初始化
    
    while(1){
        Read_Sensors();     // 读取传感器数据
        Process_Data();     // 数据处理
        Display_Data();     // 本地显示
        
        if(Need_Upload()){  // 需要上传数据
            Gizwits_Upload();
        }
        
        Check_Alarm();      // 检查报警
        DelayMs(1000);      // 每秒执行一次
    }
}

7.2 按键处理逻辑

四个按键实现参数设置功能：

• KEY1：进入/退出设置模式
• KEY2：选择设置项
• KEY3：数值增加
• KEY4：数值减少并保存

void Key_Handler(void)
{
    if(KEY1_Pressed()){        // 进入设置模式
        mode = (mode + 1) % 2;
        if(mode == 0){         // 退出设置，保存数据
            Save_To_Flash();
        }
    }
    
    if(mode == 1){             // 设置模式
        if(KEY2_Pressed()){    // 切换设置项
            current_item = (current_item + 1) % 4;
        }
        if(KEY3_Pressed()){    // 数值增加
            params[current_item] += 1;
        }
        if(KEY4_Pressed()){    // 数值减少
            params[current_item] -= 1;
        }
    }
}

按键处理要加入防抖功能，否则会出现误触发：

uint8_t Is_Key_Pressed(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin)
{
    static uint32_t last_time = 0;
    if(HAL_GPIO_ReadPin(GPIOx, GPIO_Pin) == 0){
        if(HAL_GetTick() - last_time > 50){ // 防抖50ms
            last_time = HAL_GetTick();
            return 1;
        }
    }
    return 0;
}

7.3 报警逻辑实现

报警条件判断：

void Check_Alarm(void)
{
    if((current_ph < ph_low) || (current_ph > ph_high)){
        Trigger_Alarm(PH_ALARM);
    }
    if(current_turbidity > turbidity_max){
        Trigger_Alarm(TURBIDITY_ALARM);
    }
    if(current_temp > temp_max){
        Trigger_Alarm(TEMP_ALARM);
    }
}

void Trigger_Alarm(Alarm_Type type)
{
    Buzzer_On();                    // 蜂鸣器报警
    OLED_Show_Alarm(type);          // 显示报警信息
    Gizwits_Upload_Alarm(type);     // 上传报警信息
    Send_APP_Notification(type);    // 发送手机通知
}

报警后需要手动确认才能停止蜂鸣器，否则会一直报警：

void Alarm_Handler(void)
{
    if(alarm_active && KEY4_Pressed()){
        Buzzer_Off();           // 停止蜂鸣器
        alarm_active = 0;        // 清除报警状态
    }
}

8. 系统调试与优化

8.1 常见问题解决

在开发过程中，我遇到了一些典型问题：

传感器读数不稳定：

• 原因：电源噪声或接线不良
• 解决：增加滤波电容，使用屏蔽线，软件滤波

ESP8266连接不稳定：

• 原因：电源功率不足或信号干扰
• 解决：单独给ESP8266供电，增加重连机制

数据上传失败：

• 原因：网络问题或服务器连接超时
• 解决：增加超时重发机制，检查数据格式

8.2 功耗优化

如果使用电池供电，需要优化功耗：

void Enter_Low_Power_Mode(void)
{
    // 关闭不用的外设
    __HAL_RCC_ADC1_CLK_DISABLE();
    __HAL_RCC_USART2_CLK_DISABLE();
    
    // 设置睡眠模式
    HAL_PWR_EnterSLEEPMode(PWR_MAINREGULATOR_ON, PWR_SLEEPENTRY_WFI);
    
    // 唤醒后重新初始化外设
    __HAL_RCC_ADC1_CLK_ENABLE();
    __HAL_RCC_USART2_CLK_ENABLE();
    ADC_Init();
    USART2_Init();
}

我测试过，在低功耗模式下，系统平均电流从50mA降到15mA，续航时间大大延长。

8.3 可靠性提升

为了提高系统可靠性，我增加了以下功能：

看门狗定时器：

void IWDG_Init(void)
{
    hiwdg.Instance = IWDG;
    hiwdg.Init.Prescaler = IWDG_PRESCALER_32;
    hiwdg.Init.Reload = 0xFFF;
    hiwdg.Init.Window = 0xFFF;
    HAL_IWDG_Init(&hiwdg);
}

void Feed_Dog(void)
{
    HAL_IWDG_Refresh(&hiwdg);
}

数据备份机制： 重要参数保存在Flash中，防止断电丢失：

void Save_To_Flash(uint32_t address, uint32_t *data, uint16_t size)
{
    HAL_FLASH_Unlock();
    FLASH_Erase_Sector(FLASH_SECTOR_1, VOLTAGE_RANGE_3);
    
    for(uint16_t i=0; i<size; i++){
        HAL_FLASH_Program(FLASH_TYPEPROGRAM_WORD, address + i*4, data[i]);
    }
    
    HAL_FLASH_Lock();
}

在实际使用中，这些措施大大提高了系统的稳定性。特别是在现场环境中，电网波动较大，看门狗机制避免了系统死机。

9. 实际应用案例

我将这个系统用在了家里的鱼缸和阳台的植物水培系统中，效果很不错。

鱼缸监测案例：

• 监测参数：温度（25±2℃）、PH值（7.0±0.5）、浊度
• 报警设置：温度超过28℃或低于22℃报警，PH值超过7.5或低于6.5报警
• 实际效果：及时发现了一次加热棒故障（温度异常下降），避免了鱼群死亡

水培系统案例：

• 监测参数：PH值（5.5-6.5）、营养液浓度（通过浊度间接反映）
• 自动控制：根据PH值自动添加酸碱调节剂
• 节省人力：从每天手动检测变为每周检查一次系统

这些实际应用证明，这个水质监测系统确实实用可靠。特别是在水培系统中，自动调节PH值功能大大减少了维护工作量。

10. 进阶扩展功能

基础系统完成后，还可以进一步扩展：

多节点组网： 使用多个监测节点覆盖大面积水域，数据通过LoRa或Zigbee汇集到网关节点，再上传到云平台。我测试过LoRa传输距离，在开阔地带能达到2公里以上。

自动控制功能： 根据水质参数自动控制水泵、增氧机、投饵机等设备。比如当浊度超标时自动启动过滤泵，当PH值偏低时自动添加调节剂。

太阳能供电： 对于户外应用，可以增加太阳能板和锂电池，实现完全无线化。我测试过10W的太阳能板配合20Ah的锂电池，在晴天条件下可以持续工作。

数据分析和预测： 通过历史数据训练机器学习模型，预测水质变化趋势，提前预警。虽然这个功能比较复杂，但对于大型养殖场很有价值。

我在一个锦鲤养殖场部署了这个系统，老板最赞赏的是手机报警功能，让他即使不在场也能及时了解水质情况，避免了多次损失。

经过几个月的实际使用，这个系统表现稳定可靠。最让我满意的是它的性价比——全部硬件成本不到200元，却实现了商业级的功能。如果你正在寻找一个简单实用的水质监测方案，这个项目绝对值得一试。