用STM32和OLED屏做个土壤湿度监测仪（附完整代码和接线图）

STM32与OLED打造智能土壤湿度监测仪：从硬件搭建到代码实战

在智能家居和精准农业逐渐普及的今天，环境监测设备的DIY制作成为了电子爱好者和创客们热衷的项目。本文将带你用STM32微控制器和OLED显示屏，配合常见的土壤湿度传感器，打造一个既实用又能学到嵌入式开发核心技能的桌面监测工具。不同于简单的教程复制，我们会深入探讨传感器原理、硬件优化和代码架构设计，让你真正掌握从零件到成品的完整开发流程。

1. 项目核心组件与工作原理

1.1 土壤湿度传感器深度解析

市面常见的电阻式土壤湿度传感器（如FC-28）通过检测土壤导电性来判断含水量。其核心是一个镀镍的探头，具有以下技术特性：

• 工作电压：3.3V-5V宽电压设计
• 输出信号：同时提供数字量(DO)和模拟量(AO)输出
• 比较器电路：采用LM393芯片确保信号稳定
• 阈值调节：蓝色电位器可调整湿度触发点

实际测试中发现，长时间使用后探头易受电解腐蚀影响。建议在使用前涂抹凡士林保护，并定期清洁探头表面。

传感器输出电压与湿度关系近似如下表：

1.2 STM32的ADC采集关键配置

STM32F103C8T6内置12位ADC，配置时需注意：

void AD_Init(void) { RCC_APB2PeriphClockCmd(RCC_APB2Periph_ADC1, ENABLE); RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); RCC_ADCCLKConfig(RCC_PCLK2_Div6); // 设置ADC时钟为12MHz GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AIN; GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0; GPIO_Init(GPIOA, &GPIO_InitStructure); ADC_RegularChannelConfig(ADC1, ADC_Channel_0, 1, ADC_SampleTime_55Cycles5); ADC_InitTypeDef ADC_InitStructure; ADC_InitStructure.ADC_Mode = ADC_Mode_Independent; ADC_InitStructure.ADC_DataAlign = ADC_DataAlign_Right; ADC_InitStructure.ADC_ExternalTrigConv = ADC_ExternalTrigConv_None; ADC_InitStructure.ADC_ContinuousConvMode = DISABLE; ADC_InitStructure.ADC_ScanConvMode = DISABLE; ADC_InitStructure.ADC_NbrOfChannel = 1; ADC_Init(ADC1, &ADC_InitStructure); ADC_Cmd(ADC1, ENABLE); ADC_ResetCalibration(ADC1); while(ADC_GetResetCalibrationStatus(ADC1)); ADC_StartCalibration(ADC1); while(ADC_GetCalibrationStatus(ADC1)); }

1.3 OLED显示模块驱动优化

SSD1306驱动的0.96寸OLED（128x64分辨率）采用硬件I2C接口时，需特别注意时序控制。以下是经过优化的关键函数：

void OLED_WriteCommand(uint8_t Command) { OLED_I2C_Start(); OLED_I2C_SendByte(0x78); // 从机地址 OLED_I2C_SendByte(0x00); // 命令标识 OLED_I2C_SendByte(Command); OLED_I2C_Stop(); } void OLED_ShowNum(uint8_t Line, uint8_t Column, uint32_t Number, uint8_t Length) { uint8_t i; for(i=0; i<Length; i++) { OLED_ShowChar(Line, Column+i, Number/OLED_Pow(10,Length-i-1)%10+'0'); } }

2. 硬件连接与电路设计

2.1 完整接线方案

采用四线制连接方式，具体接线如下表所示：

OLED显示屏连接：

2.2 电源设计注意事项

• 建议为传感器单独供电线路添加100μF电容滤波
• 若使用锂电池供电，需增加低压检测电路
• OLED工作电流约20mA，确保电源能提供足够电流

实际搭建时，曾遇到电源噪声导致ADC读数不稳的问题。通过在传感器VCC和GND之间添加0.1μF陶瓷电容解决了该问题。

3. 软件架构与核心代码实现

3.1 主程序逻辑设计

采用模块化编程思想，主要包含以下功能模块：

1. 硬件抽象层：AD.c、OLED.c、Delay.c
2. 应用逻辑层：数据采集与处理
3. 显示层：信息可视化呈现

主程序流程图：

初始化硬件 → 读取ADC值 → 转换为电压 → 计算湿度百分比 → OLED显示 → 延时循环

3.2 数据采集与处理算法

uint16_t AD_GetValue(void) { ADC_SoftwareStartConvCmd(ADC1, ENABLE); while(ADC_GetFlagStatus(ADC1, ADC_FLAG_EOC) == RESET); return ADC_GetConversionValue(ADC1); } float GetSoilHumidity(uint16_t adcValue) { // 校准数据：在完全干燥和水中浸泡状态下获取的ADC值 const uint16_t DRY_VALUE = 4095; // 3.3V对应值 const uint16_t WET_VALUE = 860; // 实测水中值 // 限制范围并计算百分比 if(adcValue > DRY_VALUE) adcValue = DRY_VALUE; if(adcValue < WET_VALUE) adcValue = WET_VALUE; return 100.0f - ((float)(adcValue - WET_VALUE) / (DRY_VALUE - WET_VALUE)) * 100.0f; }

3.3 显示界面优化技巧

通过分层显示提高信息可读性：

void UpdateDisplay(uint16_t adcValue, float humidity) { OLED_ShowString(1, 1, "ADC:"); OLED_ShowNum(1, 6, adcValue, 4); OLED_ShowString(2, 1, "Humidity:"); OLED_ShowNum(2, 10, (uint16_t)humidity, 3); OLED_ShowString(2, 13, "%"); // 添加模拟进度条 uint8_t barLength = (uint8_t)(humidity / 100.0f * 12); OLED_ShowString(3, 1, "["); for(uint8_t i=0; i<12; i++) { OLED_ShowChar(3, 2+i, i<barLength ? '=' : ' '); } OLED_ShowString(3, 14, "]"); }

4. 系统校准与性能优化

4.1 传感器校准方法

1. 干校准：将传感器置于完全干燥的土壤中，记录ADC值
2. 湿校准：将传感器浸入水中，记录ADC值
3. 线性插值：建立ADC值与湿度百分比的对应关系

校准数据存储示例：

typedef struct { uint16_t dryValue; uint16_t wetValue; uint8_t calibrated; } SensorCalibration; void SaveCalibration(SensorCalibration* cal) { FLASH_Unlock(); FLASH_ErasePage(0x0800FC00); FLASH_ProgramHalfWord(0x0800FC00, cal->dryValue); FLASH_ProgramHalfWord(0x0800FC02, cal->wetValue); FLASH_ProgramHalfWord(0x0800FC04, cal->calibrated); FLASH_Lock(); }

4.2 软件滤波算法

采用移动平均滤波降低噪声影响：

#define FILTER_WINDOW_SIZE 5 uint16_t FilterADCValue(uint16_t newValue) { static uint16_t valueWindow[FILTER_WINDOW_SIZE] = {0}; static uint8_t index = 0; static uint32_t sum = 0; sum -= valueWindow[index]; valueWindow[index] = newValue; sum += newValue; index = (index + 1) % FILTER_WINDOW_SIZE; return sum / FILTER_WINDOW_SIZE; }

4.3 低功耗优化策略

1. 调整ADC采样频率为1Hz
2. 在采样间隔让STM32进入Stop模式
3. 使用定时器唤醒代替延时

void EnterLowPowerMode(void) { // 配置唤醒定时器 RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM2, ENABLE); TIM_TimeBaseInitTypeDef TIM_InitStructure; TIM_InitStructure.TIM_Period = 999; // 1秒@1kHz TIM_InitStructure.TIM_Prescaler = 31999; // 32MHz/(31999+1)=1kHz TIM_InitStructure.TIM_ClockDivision = 0; TIM_InitStructure.TIM_CounterMode = TIM_CounterMode_Up; TIM_TimeBaseInit(TIM2, &TIM_InitStructure); TIM_ITConfig(TIM2, TIM_IT_Update, ENABLE); // 进入Stop模式 PWR_EnterSTOPMode(PWR_Regulator_LowPower, PWR_STOPEntry_WFI); // 唤醒后重新初始化时钟 SystemInit(); }

5. 功能扩展与进阶应用

5.1 添加阈值报警功能

利用STM32的GPIO和定时器实现声光报警：

void CheckThreshold(float humidity) { static uint8_t alarmOn = 0; const float LOW_THRESHOLD = 30.0f; const float HIGH_THRESHOLD = 80.0f; if(humidity < LOW_THRESHOLD || humidity > HIGH_THRESHOLD) { if(!alarmOn) { TIM_Cmd(TIM3, ENABLE); // 启动蜂鸣器PWM GPIO_SetBits(GPIOC, GPIO_Pin_13); // LED亮 alarmOn = 1; } } else { if(alarmOn) { TIM_Cmd(TIM3, DISABLE); GPIO_ResetBits(GPIOC, GPIO_Pin_13); alarmOn = 0; } } }

5.2 数据记录与导出

添加SD卡模块实现数据记录：

void LogDataToSD(uint16_t adcValue, float humidity) { static FIL file; static uint8_t firstRun = 1; if(firstRun) { f_mount(&fs, "", 0); f_open(&file, "datalog.txt", FA_WRITE | FA_OPEN_ALWAYS); f_lseek(&file, f_size(&file)); firstRun = 0; } char buffer[64]; sprintf(buffer, "%lu, %u, %.1f\r\n", GetTickCount(), adcValue, humidity); UINT bytesWritten; f_write(&file, buffer, strlen(buffer), &bytesWritten); f_sync(&file); }

5.3 无线传输与云端监控

通过ESP8266模块实现WiFi上传：

void SendToCloud(float humidity) { char cmd[128]; sprintf(cmd, "AT+CIPSTART=\"TCP\",\"api.thingspeak.com\",80\r\n"); SendATCommand(cmd, 2000); sprintf(cmd, "POST /update HTTP/1.1\r\nHost: api.thingspeak.com\r\n" "Connection: close\r\nX-THINGSPEAKAPIKEY: YOUR_KEY\r\n" "Content-Type: application/x-www-form-urlencoded\r\n" "Content-Length: 15\r\n\r\nfield1=%.1f\r\n", humidity); sprintf(cmd, "AT+CIPSEND=%d\r\n", strlen(cmd)); SendATCommand(cmd, 1000); SendATCommand(cmd, 1000); }

6. 常见问题排查与解决

6.1 ADC读数不稳定

可能原因及解决方案：

1. 电源噪声：
   • 增加滤波电容
   • 使用线性稳压器而非开关电源
2. 接地问题：
   • 确保所有地线良好连接
   • 采用星型接地布局
3. 软件问题：
   • 增加软件滤波
   • 检查ADC时钟配置

6.2 OLED显示异常

典型故障现象与处理：

6.3 传感器寿命短

延长传感器寿命的实用技巧：

• 采用间歇工作模式，减少电解腐蚀
• 探头表面涂敷防水涂层
• 避免长时间在高湿度环境中连续工作
• 定期用酒精棉签清洁探头

7. 项目进阶方向

7.1 多节点组网监测

使用LoRa或Zigbee模块构建分布式监测网络：

// LoRa节点代码示例 void SendLoRaPacket(float humidity) { uint8_t buffer[4]; *(float*)buffer = humidity; Radio.SetTxPower(14, PA_OUTPUT_PA_BOOST_PIN); Radio.SetFrequency(433.775); Radio.Send(buffer, sizeof(buffer), 3000); }

7.2 机器学习异常检测

在STM32上实现简单机器学习算法：

// 移动平均和标准差计算 typedef struct { float values[10]; uint8_t index; float sum; float sumSq; } MovingStats; void UpdateStats(MovingStats* stats, float newValue) { stats->sum -= stats->values[stats->index]; stats->sumSq -= stats->values[stats->index] * stats->values[stats->index]; stats->values[stats->index] = newValue; stats->sum += newValue; stats->sumSq += newValue * newValue; stats->index = (stats->index + 1) % 10; } float CheckAnomaly(MovingStats* stats, float newValue) { float mean = stats->sum / 10; float stddev = sqrt((stats->sumSq - 10*mean*mean)/9); return fabs(newValue - mean) > 2*stddev; }

7.3 太阳能供电系统设计

优化电源管理实现自维持：

1. 太阳能板选型：6V/2W板子配合TP4056充电模块
2. 电池选择：18650锂电池（3400mAh）
3. 功耗控制：
   • 采集间隔延长至5分钟
   • 深度睡眠模式下电流<50μA
4. 电源路径管理：

void PowerManagement_Init(void) { // 配置ADC监测电池电压 ADC_RegularChannelConfig(ADC1, ADC_Channel_17, 1, ADC_SampleTime_239Cycles5); // 配置唤醒引脚 GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IPU; GPIO_Init(GPIOA, &GPIO_InitStructure); // 配置外部中断唤醒 EXTI_InitTypeDef EXTI_InitStructure; EXTI_InitStructure.EXTI_Line = EXTI_Line0; EXTI_InitStructure.EXTI_Mode = EXTI_Mode_Interrupt; EXTI_InitStructure.EXTI_Trigger = EXTI_Trigger_Rising; EXTI_InitStructure.EXTI_LineCmd = ENABLE; EXTI_Init(&EXTI_InitStructure); }

8. 实际应用案例分享

8.1 家庭盆栽智能养护系统

集成浇水控制功能：

void AutoWateringControl(float humidity) { const float WATERING_THRESHOLD = 40.0f; static uint32_t lastWateringTime = 0; if(humidity < WATERING_THRESHOLD && (GetTickCount() - lastWateringTime) > 3600000) { // 1小时最小间隔 GPIO_SetBits(GPIOB, GPIO_Pin_12); // 打开电磁阀 Delay_ms(5000); // 浇水5秒 GPIO_ResetBits(GPIOB, GPIO_Pin_12); lastWateringTime = GetTickCount(); } }

8.2 农业大棚监测网络

多参数监测系统架构：

1. 主控节点：STM32F407 + 4G模块
2. 传感器节点：STM32F103 + LoRa
3. 监测参数：
   • 土壤湿度（多层）
   • 空气温湿度
   • 光照强度
4. 数据平台：ThingsBoard开源IoT平台

8.3 科研级土壤分析仪

高精度版本改进点：

• 采用TDR原理传感器（如CS650）
• 增加温度补偿算法
• 添加pH值检测模块
• 实现数据标定和曲线拟合

float CompensatedHumidity(float rawHumidity, float temperature) { // 温度补偿公式：基于实验数据拟合 return rawHumidity * (1.0f + 0.02f * (temperature - 25.0f)); }