3. 读取模拟传感器数据：土壤湿度监测与ADC转换实战
好，咱们进入第三个实战环节。前面两章我们把硬件搭好了，开发环境也配好了。现在，是时候让ESP32真正“感知”土壤湿度了。
这一章的核心就两件事：第一，写代码读出模拟值；第二，搞懂ADC到底在干什么。别小看这两步，我见过太多新手卡在这里——要么读出来全是0或4095，要么数值乱跳。嗯，咱们一步步来。
3.1 先聊聊ADC：模拟世界到数字世界的“翻译官”
土壤湿度传感器输出的，是一个模拟电压信号。说白了，就是电压会随着湿度变化而连续变化。但ESP32是数字芯片，它只认0和1。怎么办？
这时候就需要ADC（模数转换器）出场了。它的工作，就是把连续的电压值，转换成离散的数字量。
我个人习惯把ADC理解成一个“电压尺子”。ESP32内置的ADC是12位的，什么意思？就是它把0~3.3V的电压范围，等分成了2^12 = 4096份。每一份对应一个数字值，从0到4095。
核心公式（心里有数就行）：
数字值 = (输入电压 / 参考电压) × 4095
举个例子：如果输入1.65V，那么数字值 ≈ (1.65 / 3.3) × 4095 ≈ 2047
你想想看，土壤越湿，传感器输出的电压就越低（或者越高，取决于你的传感器类型）。我们读到的ADC值就会相应变化。这就是监测湿度的基本原理。
一个小经验： 我刚开始做项目时，总以为ADC值越精确越好。后来发现，对于土壤湿度这种“模糊”的物理量，12位的分辨率完全够用。别追求极致精度，稳定才是王道。
3.2 编写代码：让ESP32开口说话
好，理论说完了，咱们直接上代码。打开你的Arduino IDE，新建一个文件，把下面这段敲进去。
// 第3章：读取土壤湿度模拟值
// 硬件连接：传感器OUT -> GPIO34 (ADC1_CH6)
#define SOIL_SENSOR_PIN 34 // 定义模拟输入引脚
void setup() {
Serial.begin(115200); // 初始化串口，波特率115200
Serial.println("土壤湿度监测启动！");
Serial.println("ADC值范围：0 ~ 4095");
Serial.println("-----------------------------");
}
void loop() {
int sensorValue = analogRead(SOIL_SENSOR_PIN); // 读取ADC值
// 打印原始ADC值
Serial.print("ADC原始值: ");
Serial.print(sensorValue);
// 可选：将ADC值映射为电压值（单位：mV）
float voltage = sensorValue * (3300.0 / 4095.0);
Serial.print(" | 对应电压: ");
Serial.print(voltage);
Serial.println(" mV");
delay(1000); // 每秒读取一次
}代码很简单，但我得提醒你几个关键点：
- 引脚选择：ESP32的ADC2在某些情况下（比如WiFi开启时）会有干扰。我个人习惯优先使用ADC1的引脚（GPIO32~GPIO39）。这里用GPIO34，稳得很。
- analogRead()：这是Arduino框架封装好的函数，直接返回0~4095的整数。底层其实调用了ESP32的ADC驱动库。
- 电压换算：我把ADC值换算成了毫伏（mV），方便你直观理解。3300是3.3V对应的毫伏数。
注意！ ESP32的ADC在输入电压接近0V或3.3V时，线性度会变差。我曾经遇到过一个问题：传感器在干燥空气中输出接近3.3V，读出来一直是4095，完全没变化。后来发现是传感器供电电压不稳导致的。解决办法：给传感器单独供电，或者用分压电路把电压范围压缩到0.1V~3.2V之间。
3.3 上传并观察：串口监视器里的“湿度密码”
代码写好了，点击上传。等它编译完成，烧录进ESP32。然后打开串口监视器（Tools -> Serial Monitor），把波特率调到115200。
你会看到类似这样的输出：
土壤湿度监测启动！
ADC值范围：0 ~ 4095
-----------------------------
ADC原始值: 2845 | 对应电压: 2291.58 mV
ADC原始值: 2847 | 对应电压: 2293.19 mV
ADC原始值: 2842 | 对应电压: 2289.16 mV
ADC原始值: 2848 | 对应电压: 2294.98 mV看到了吗？数值在轻微波动。这是正常的，因为传感器本身有噪声，ADC采样也有微小误差。
现在，做个小实验：
- 把手洗干净，用手指捏住传感器的两个探针（模拟湿润土壤）。
- 观察串口监视器，ADC值应该会明显下降（或上升，取决于你的传感器类型）。
- 松开手，让探针在空气中自然干燥，数值会慢慢恢复。
为什么会这样？因为你的手指提供了导电通路，改变了传感器内部的电阻分压。这就是土壤湿度监测的物理基础。
我的一个小技巧： 别只看原始ADC值。我习惯在代码里加一个滑动平均滤波，比如连续取5次读数，去掉最大值和最小值，再取平均。这样能有效抑制噪声。代码很简单，你可以自己试试看。
3.4 深入理解：ADC的几个“坑”与应对
搞嵌入式这么多年，ADC这块我踩过的坑真不少。给你总结几个最常见的：
| 问题现象 | 可能原因 | 我的解决方案 |
|---|---|---|
| 读数始终为0 | 引脚未连接、传感器损坏、GPIO被占用 | 检查接线，换一个ADC1引脚试试 |
| 读数始终为4095 | 输入电压超过3.3V、传感器输出饱和 | 用万用表测传感器输出端电压 |
| 数值剧烈跳动 | 电源噪声、传感器接触不良 | 加一个100nF电容在传感器电源和地之间 |
| WiFi开启后读数异常 | 使用了ADC2引脚 | 改用ADC1引脚（GPIO32~39） |
嗯，这里要特别强调一下：ESP32的ADC并不是高精度器件。它的非线性误差大约在±2%左右。如果你需要精确测量电压，建议外挂一个独立的ADC芯片（比如ADS1115）。但对于咱们的智能浇花项目，这个精度绰绰有余。
3.5 本章小结与思考
这一章，我们完成了从“硬件连接”到“数据读取”的关键一步。你现在应该能：
- 理解ADC的基本原理：把模拟电压映射成数字量
- 编写代码读取ESP32的模拟输入
- 通过串口监视器观察数据变化
- 识别并解决常见的ADC问题
下一章，我们会基于这些原始数据，编写逻辑代码——让ESP32根据湿度值自动控制水泵。但在此之前，我建议你多花点时间观察数据。把传感器放在不同湿度的土壤里，记录下对应的ADC值范围。这些数据，就是你后续设定“浇水阈值”的依据。
记住一句话：没有数据，就没有控制。搞物联网，第一步永远是“感知”。
好了，动手试试吧。有任何问题，欢迎在课程群里交流。咱们下章见。