用STM32F103C8T6做个智能花盆：土壤湿度传感器ADC采集与OLED显示保姆级教程

用STM32F103C8T6打造智能花盆：从传感器到显示的完整实现指南

周末给阳台的多肉植物浇水时，突然想到能否用手边的STM32开发板做个自动监测装置。这个念头最终演变成了一个完整的智能花盆项目——通过土壤湿度传感器采集数据，在OLED屏上直观显示植物"口渴"程度。作为电子爱好者，我们追求的不仅是功能实现，更是理解每个环节的技术细节。

市面上大多数教程只给出代码片段，而本文将带你完整走通硬件连接、ADC采集、数据转换和显示输出的全流程。你会学到如何用STM32F103C8T6这块性价比极高的MCU，配合常见的YL-69土壤湿度传感器和0.96寸OLED，构建一个具有实用价值的智能园艺设备。

1. 项目规划与硬件选型

1.1 核心组件功能解析

STM32F103C8T6作为主控芯片，其内置的12位ADC模块是关键所在。这款Cortex-M3内核的MCU有高达72MHz的主频，足以流畅处理传感器数据转换和显示刷新。相比Arduino，STM32的ADC精度更高（4096级vs 1024级），特别适合需要精确测量的场景。

YL-69土壤湿度传感器的工作原理其实很简单：通过探针间的电阻变化反映土壤含水量。输出方式有两种：

• 数字信号（DO）：简单的高低电平阈值判断
• 模拟信号（AO）：输出0-3.3V连续电压值

我们将使用模拟输出，因为：

1. 能反映湿度连续变化
2. 可通过校准获得更精确的百分比读数
3. 避免数字输出的"非湿即干"二值化问题

SSD1306驱动的0.96寸OLED选择I2C接口版本，只需4根线就能实现显示。其128x64的分辨率足够显示：

• 实时湿度数值
• 历史趋势简图
• 系统状态提示

1.2 完整物料清单

提示：购买传感器时注意选择工作电压3.3V版本，避免电平不兼容问题。部分厂家会标注"3.3/5V兼容"。

2. 硬件电路搭建

2.1 传感器接口设计

YL-69传感器有4个引脚需要连接：

1. VCC → 3.3V
2. GND → GND
3. DO → 悬空（不使用）
4. AO → PA5（ADC1通道5）

实际接线时会发现一个有趣现象：干燥环境下AO输出电压接近VCC，湿润时趋近于0。这是因为水分子增加了土壤导电性，降低了探针间电阻。这种反比关系需要在代码中进行处理。

ADC输入电路建议增加一个简单的RC滤波：

PA5 ───┬───→ 10KΩ ───┐ │ │ === 0.1μF │ │ │ GND ADC_IN5

2.2 OLED显示模块连接

I2C接口的OLED只需要4线连接：

• SCL → PB6
• SDA → PB7
• VCC → 3.3V
• GND → GND

记得给I2C总线加上拉电阻：

// 硬件连接示意图 +3.3V───10KΩ───SCL │ OLED │ +3.3V───10KΩ───SDA

2.3 电源方案考虑

虽然开发板可通过USB供电，但长期运行建议：

1. 使用手机充电器+Micro USB供电
2. 或接18650锂电池+TP4056充电模块
3. 如需低功耗，可启用STM32的睡眠模式

3. 软件实现详解

3.1 ADC采集配置要点

STM32的ADC初始化有几个关键参数需要注意：

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; // 1个转换通道

采样时间设置很有讲究，对于土壤湿度这种变化缓慢的信号：

ADC_RegularChannelConfig(ADC1, ch, 1, ADC_SampleTime_239Cycles5);

这个239.5周期的采样时间能确保充分采样，减少噪声干扰。

3.2 数据滤波算法实现

直接读取ADC原始值会存在波动，采用移动平均滤波：

#define SAMPLE_TIMES 20 // 采样次数 uint16_t get_filtered_adc(uint8_t channel) { uint32_t sum = 0; for(uint8_t i=0; i<SAMPLE_TIMES; i++){ sum += adc_read(channel); delay_ms(5); // 适当间隔 } return sum / SAMPLE_TIMES; }

更高级的做法可以结合中值滤波：

1. 采集奇数个样本（如15个）
2. 排序后取中间值
3. 再对中间值做平均

3.3 湿度百分比转换

传感器输出电压与湿度成反比，需要转换：

float convert_to_percent(uint16_t adc_val) { const float Vref = 3.3f; // 参考电压 const uint16_t max_adc = 4095; // 12位ADC最大值 // 读取电压值 float voltage = (float)adc_val * Vref / max_adc; // 反比转换（需校准） float humidity = 100.0f - (voltage * 100.0f / Vref); // 限制在0-100%范围内 return fmaxf(0.0f, fminf(100.0f, humidity)); }

实际项目中建议增加校准步骤：

1. 将传感器完全浸入水中，记录此时ADC值（100%湿度）
2. 将传感器置于干燥空气中，记录ADC值（0%湿度）
3. 建立线性映射关系

4. OLED界面设计与优化

4.1 显示布局规划

有效的UI设计应该包含：

• 顶部：项目名称和状态图标
• 中部：大号字体显示湿度百分比
• 底部：历史趋势简图或文字提示

示例布局：

+----------------------+ | 智能花盆 [电池图标] | | | | 湿度: 65.2% | | | | [=====------] 50-80% | +----------------------+

4.2 图形化显示实现

利用SSD1306的绘图功能创建直观显示：

// 绘制湿度条 void draw_humidity_bar(uint8_t percent) { uint8_t bar_width = (percent * 100) / 128; OLED_DrawRectangle(10, 40, 118, 48, 1); OLED_Fill(12, 42, 12+bar_width, 46, 1); // 添加标尺 OLED_ShowString(10, 50, "0%", 8); OLED_ShowString(110, 50, "100%", 8); }

4.3 低功耗优化技巧

1. 降低刷新频率（从60Hz降到1-2Hz）
2. 使用局部刷新代替全屏刷新
3. 在无变化时关闭背光
4. 实现唤醒-睡眠循环：

while(1) { update_display(); enter_stop_mode(); // 进入低功耗模式 delay_ms(2000); // 2秒唤醒一次 }

5. 项目进阶与扩展

完成基础功能后，可以考虑：

• 增加蓝牙模块，手机远程查看数据
• 添加水泵控制，实现自动浇水
• 记录历史数据，分析植物需水规律
• 集成温湿度传感器，完善环境监测

一个实用的自动浇水逻辑示例：

if(humidity < 30.0f && temperature < 35.0f) { pump_on(3000); // 开启水泵3秒 log_event("自动浇水"); }

硬件扩展建议：

1. 继电器控制水泵
2. DS18B20测温
3. HC-05蓝牙模块
4. SD卡数据存储

调试这类项目时，最常遇到的问题是传感器接触不良。我的经验是给探针涂一层导电漆，既能防腐蚀又能保持良好接触。另一个坑是OLED的I2C地址——部分屏是0x3C，有些是0x78，遇到显示不正常时先用I2C扫描工具确认地址。