当前位置： 首页 > news >正文

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

news 2026/5/30 9:51:46

从零打造智能土壤湿度监测仪：STM32+OLED实战指南

在智能家居和精准农业蓬勃发展的今天，环境监测设备的DIY制作正成为技术爱好者的新宠。本文将带你完整实现一个基于STM32的土壤湿度监测系统，不仅能实时检测土壤水分含量，还能通过OLED屏幕直观显示数据。不同于简单的传感器驱动教程，我们将从元器件选型、电路设计、代码编写到系统调试，全方位呈现一个可落地的完整项目。

1. 项目规划与硬件选型

1.1 核心器件选择

一个可靠的土壤监测系统需要精心挑选每个组件。经过多次项目实践，我总结出以下性价比方案：

组件类型推荐型号关键参数成本估算
主控芯片STM32F103C8T672MHz Cortex-M3, 64KB Flash￥15-20
土壤湿度传感器电容式V1.20-3.3V模拟输出，防腐镀层￥8-12
显示模块0.96寸OLED(I2C接口)128x64分辨率，低功耗￥18-25
供电方案AMS1117-3.3稳压模块输入5V，输出3.3V/1A￥3-5

提示：电容式传感器比电阻式更耐用，但首次使用前需要校准。建议购买带有镀金处理的版本，防止土壤腐蚀。

1.2 电路设计要点

硬件连接看似简单，但有几个易错点需要特别注意：

// 典型连接方式 STM32F103C8T6 外围设备 PA0 <-------------- 传感器AO引脚 PB6 <-------------- OLED SCL PB7 <-------------- OLED SDA 3.3V <-------------- 传感器VCC GND <-------------- 共地连接
  • 电源去耦：在STM32的3.3V和GND之间添加0.1μF陶瓷电容，特别当使用长导线连接传感器时
  • I2C上拉：OLED的SCL和SDA线需接4.7kΩ上拉电阻至3.3V（部分模块已内置）
  • 传感器保护：在AO引脚串联1kΩ电阻可防止意外短路损坏ADC端口

2. 开发环境搭建

2.1 工具链配置

推荐使用以下软件组合，经过多个项目验证最为稳定：

  1. Keil MDK-ARM：5.23以上版本，安装STM32F1支持包
  2. ST-Link Utility：用于固件烧录和调试
  3. 串口调试助手：推荐使用SecureCRT或Putty
  4. 代码编辑器：VS Code + Cortex-Debug扩展

安装完成后，需要特别注意两点：

  • 在Keil的Options for Target中，将C/C++选项卡的优化等级设置为-O0（调试阶段）
  • 勾选"Use MicroLIB"以减小代码体积

2.2 工程模板创建

避免从零开始构建工程，推荐使用标准外设库模板：

# 克隆标准外设库模板 git clone https://github.com/STMicroelectronics/STM32F1xx_StdPeriph_Lib

关键目录结构说明：

├── Libraries │ ├── CMSIS # 核心支持包 │ └── STM32F10x_StdPeriph_Driver # 外设驱动 ├── Project │ └── Template # 工程模板 └── Utilities # 评估板专用代码

3. 传感器驱动开发

3.1 ADC采集配置

土壤湿度传感器的模拟输出需要精确采集，以下是经过优化的ADC初始化代码：

// adc.h #ifndef __ADC_H #define __ADC_H #include "stm32f10x.h" void ADC1_Init(void); uint16_t ADC_GetValue(uint8_t ch); float ADC_GetVoltage(uint8_t ch); #endif
// adc.c #include "adc.h" void ADC1_Init(void) { RCC_APB2PeriphClockCmd(RCC_APB2Periph_ADC1 | RCC_APB2Periph_GPIOA, ENABLE); GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0; // PA0为传感器接口 GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AIN; GPIO_Init(GPIOA, &GPIO_InitStructure); ADC_InitTypeDef ADC_InitStructure; ADC_InitStructure.ADC_Mode = ADC_Mode_Independent; ADC_InitStructure.ADC_ScanConvMode = DISABLE; ADC_InitStructure.ADC_ContinuousConvMode = DISABLE; ADC_InitStructure.ADC_ExternalTrigConv = ADC_ExternalTrigConv_None; ADC_InitStructure.ADC_DataAlign = ADC_DataAlign_Right; ADC_InitStructure.ADC_NbrOfChannel = 1; ADC_Init(ADC1, &ADC_InitStructure); ADC_Cmd(ADC1, ENABLE); // ADC校准流程（必须执行） ADC_ResetCalibration(ADC1); while(ADC_GetResetCalibrationStatus(ADC1)); ADC_StartCalibration(ADC1); while(ADC_GetCalibrationStatus(ADC1)); } uint16_t ADC_GetValue(uint8_t ch) { ADC_RegularChannelConfig(ADC1, ch, 1, ADC_SampleTime_239Cycles5); ADC_SoftwareStartConvCmd(ADC1, ENABLE); while(!ADC_GetFlagStatus(ADC1, ADC_FLAG_EOC)); return ADC_GetConversionValue(ADC1); } float ADC_GetVoltage(uint8_t ch) { return (float)ADC_GetValue(ch) * 3.3f / 4095; }

3.2 传感器校准技巧

土壤湿度传感器需要湿度和电压的对应关系校准，这里分享我的校准方法：

  1. 完全干燥校准：

    • 将传感器置于完全干燥的土壤中
    • 记录ADC值（通常为最大值，约4095）

  2. 完全湿润校准：

    • 将传感器浸入清水中10秒
    • 取出擦干表面后立即测量（通常为最小值，约800-1200）

  3. 建立转换公式：

    // 在main.c中定义校准参数 #define DRY_VALUE 4095 #define WET_VALUE 950 float GetHumidityPercent(uint16_t adc_val) { return 100.0f * (DRY_VALUE - adc_val) / (DRY_VALUE - WET_VALUE); }

注意：不同土壤类型的导电特性差异很大，建议针对具体应用场景进行实地校准。黏土和沙土的湿度-电压曲线可能有显著不同。

4. OLED显示实现

4.1 显示屏驱动优化

市面上常见的0.96寸OLED多使用SSD1306驱动芯片，以下是经过优化的驱动代码片段：

// oled.h #ifndef __OLED_H #define __OLED_H void OLED_Init(void); void OLED_Clear(void); void OLED_ShowString(uint8_t line, uint8_t col, char *str); void OLED_ShowNum(uint8_t line, uint8_t col, uint32_t num, uint8_t len); void OLED_ShowFloat(uint8_t line, uint8_t col, float num, uint8_t prec); #endif

关键优化点包括：

  • 采用DMA传输提升刷新效率
  • 实现双缓冲机制避免闪烁
  • 添加浮点数直接显示功能

4.2 用户界面设计

良好的数据显示方式能大幅提升使用体验。推荐采用这种布局：

+----------------------+ | SOIL MOISTURE MONITOR| +----------------------+ | Humidity: 65.2% | | Voltage: 1.23V | | | | [====||====] | +----------------------+

进度条实现代码：

void OLED_ShowBar(uint8_t line, uint8_t col, uint8_t len, float percent) { uint8_t total = len * 5; // 每个字符占5个像素 uint8_t fill = total * percent; OLED_SetCursor(line, col); for(uint8_t i=0; i<len; i++) { if(fill >= 5) { OLED_WriteData(0xFF); // 全填充 fill -= 5; } else if(fill > 0) { OLED_WriteData(0xFF << (5-fill)); // 部分填充 fill = 0; } else { OLED_WriteData(0x00); // 空白 } } }

5. 系统集成与调试

5.1 主程序逻辑

将各模块有机结合，形成完整的监测系统：

// main.c #include "stm32f10x.h" #include "adc.h" #include "oled.h" #include "delay.h" float humidity = 0; uint16_t adc_val = 0; int main(void) { Delay_Init(); ADC1_Init(); OLED_Init(); OLED_ShowString(1, 1, "SOIL MOISTURE"); OLED_ShowString(2, 1, "Humidity:"); OLED_ShowString(3, 1, "Voltage:"); while(1) { adc_val = ADC_GetValue(ADC_Channel_0); humidity = GetHumidityPercent(adc_val); float voltage = ADC_GetVoltage(ADC_Channel_0); OLED_ShowFloat(2, 10, humidity, 1); OLED_ShowString(2, 15, "%"); OLED_ShowFloat(3, 10, voltage, 2); OLED_ShowString(3, 15, "V"); OLED_ShowBar(4, 1, 20, humidity/100.0f); Delay_ms(500); // 0.5秒更新一次 } }

5.2 常见问题排查

在实际部署中可能会遇到以下问题及解决方案：

  1. ADC读数不稳定：

    • 检查电源是否干净，可在VCC和GND之间加10μF电解电容
    • 尝试在代码中添加软件滤波：
      #define SAMPLE_TIMES 5 uint16_t ADC_GetStableValue(uint8_t ch) { uint32_t sum = 0; for(uint8_t i=0; i<SAMPLE_TIMES; i++) { sum += ADC_GetValue(ch); Delay_ms(10); } return sum / SAMPLE_TIMES; }

  2. OLED显示异常：

    • 确认I2C地址是否正确（通常0x78或0x7A）
    • 检查上拉电阻是否正常工作
    • 降低I2C时钟频率（可在初始化时设置）

  3. 传感器响应迟缓：

    • 避免将传感器完全插入土壤，留出部分通气
    • 定期清洁传感器探头，防止盐分积累

6. 项目扩展方向

基础功能实现后，可以考虑以下增强功能：

6.1 数据记录功能

添加SD卡模块，实现湿度数据长期记录：

// 文件记录格式示例 void SaveToSD(float humidity, float voltage) { FIL file; FRESULT res; char buffer[64]; res = f_open(&file, "moisture.csv", FA_OPEN_APPEND | FA_WRITE); if(res == FR_OK) { sprintf(buffer, "%lu,%.1f,%.2f\n", GetTimestamp(), humidity, voltage); UINT bytesWritten; f_write(&file, buffer, strlen(buffer), &bytesWritten); f_close(&file); } }

6.2 无线传输方案

通过ESP8266或HC-05模块实现蓝牙/WiFi数据传输：

  1. 硬件连接：

    STM32 TX <--> ESP8266 RX STM32 RX <--> ESP8266 TX 3.3V <--> VCC GND <--> GND

  2. AT指令示例：

    void ESP_SendData(float humidity) { USART_SendString("AT+CIPSTART=\"TCP\",\"api.thingspeak.com\",80\r\n"); Delay_ms(1000); char cmd[128]; sprintf(cmd, "GET /update?api_key=YOUR_KEY&field1=%.1f\r\n", humidity); USART_SendString("AT+CIPSEND="); USART_SendNumber(strlen(cmd)); USART_SendString("\r\n"); Delay_ms(500); USART_SendString(cmd); }

6.3 低功耗优化

对于电池供电的应用，可采取以下措施：

  • 将STM32设置为睡眠模式，定时唤醒采集
  • 降低系统时钟频率
  • 采用间断显示策略（如每10秒唤醒一次OLED）
  • 选择低功耗版本的传感器
// 进入停止模式示例 void Enter_StopMode(void) { RCC_APB1PeriphClockCmd(RCC_APB1Periph_PWR, ENABLE); PWR_EnterSTOPMode(PWR_Regulator_LowPower, PWR_STOPEntry_WFI); // 唤醒后需要重新配置系统时钟 SystemInit(); }

通过这个项目，你不仅能掌握STM32的基础外设使用，还能学习到传感器数据处理、用户界面设计等实用技能。当看到自己亲手制作的设备准确显示土壤湿度时，那种成就感是单纯购买成品无法比拟的。

http://www.zskr.cn/news/1426794.html

相关文章：

  • 别再花钱买授权了！手把手教你用Docker和开源方案实现USB设备网络共享（附避坑指南）
  • 2026年新疆塑料管道定制源头厂家综合对比：荣华装备科技如何成为西北基建首选 - 企业名录优选推荐
  • 实测避坑：在Win10/11 21H2企业版中，用组策略搞定域用户无感安装网络打印机（附排错指南）
  • 2026年新疆HDPE管道与市政基建工程管材供应商深度选型纲要 - 企业名录优选推荐
  • 2026塑料管材厂家推荐，PVC管材，PVC管，PE给水管，PE管厂家优选指南！ - 品牌鉴赏师
  • 工业元宇宙项目前期利器：用Win10混合现实模拟器快速原型验证（附手柄交互操作详解）
  • Niagara Editor实战：如何利用暂存区(Scratch Pad)和曲线面板高效复用特效模块
  • 告别U盘！用PXE+NFS给裸机批量装Ubuntu 22.04，一次配置，无限克隆
  • python条件分支和循环语句
  • 2026年新疆HDPE管道定制源头厂家深度横评：从昌吉阜康到全疆市政基建一站式解决攻略 - 企业名录优选推荐
  • 企业私有化AI训练推理一体工作站DLTM企业级AI模型工作站助力企业AI落地常态化
  • 别再手动下载地图JSON了！教你用ECharts官方地图扩展一键生成全国省市地图
  • 襄阳黄金回收新标杆！余生黄金回收全国连锁，免费上门卖金无忧 - 润富黄金珠宝行
  • CANN/catlass Tile行广播乘法API
  • Python yield 最通俗、最实用的讲解
  • 快手去水印视频解析在线提取：官方方法、工具风险与侵权界定全解 - 科技热点发布
  • DistilRoBERTa-Base-Paraphrase-v1-OpenMind：推荐系统中用户兴趣向量化的终极实践指南
  • 告别/dev/ttyUSB0：为思岚A2激光雷达创建永久别名，解决ROS2项目中的串口烦恼
  • GEAK框架：LLM驱动的Triton GPU内核生成技术解析
  • 避坑指南：在Vivado 2021.2中为MPSOC配置HPC接口缓存一致性（含FSBL与App代码）
  • 盘点靠谱复读名校|2026浙江高复学校名录完整版发布：覆盖杭甬温金多地 - 品牌榜中榜
  • 从GCM到流域模拟：手把手教你将CMIP6数据驱动SWAT水文模型（WRF降尺度实战）
  • 导师推荐 2026 最新降AI率软件测评与对比分析 - 降AI小能手
  • 小红书去水印下载用什么工具官方方法与安全工具及风险规避全指南 - 科技热点发布
  • 手把手教你做Claude用户手册，深度适配企业级场景的6类角色定制模板与交付清单
  • CANN/catlass FP8转FP16反量化Tile操作
  • Kimi LeetCode 2836. 在传球游戏中最大化函数值 Java实现
  • 宁波酒店厨房设备回收：江北专业的空调回收公司选哪家 - LYL仔仔
  • 【独家首发】全球首份Claude竞品压力测试报告：在金融合同解析、医疗术语推理、多跳法律检索三大高危场景中，仅2家通过95%准确率阈值
  • 2026宁夏搬家公司推荐，甄选靠谱搬家服务商打造安心搬迁体验 - 品牌鉴赏师