ESP32 ADC从原理到实战：采样跳变、通道冲突与校准全解析

做嵌入式这几年，只要有人问我ESP32最容易被低估的外设是什么，我多半会回答ADC。看起来不过是把模拟电压变成数字值，功能列表里一行“12-bit SAR ADC”轻轻带过，实际用起来才发现坑一个接一个：同一块板子量同一个电压，换一根杜邦线数值就差几十；开了WiFi之后某个通道直接乱飞；衰减档位没选对，量出来的电压要么“顶天”要么“探头探脑”。这篇文章就围绕ESP32的ADC展开，从硬件工作原理讲到ESP-IDF与Arduino两套驱动实践，再把采样跳变、通道冲突、校准曲线这些日常踩坑一次说清。适合刚接触ESP32的新手，也适合已经用了一阵子但觉得读数“不准”的开发者。

1. 硬件层面的第一课：ESP32的ADC到底是怎么工作的

1.1 两个ADC与它们的通道布局

经典ESP32（双核版本）内部集成了两个逐次逼近型ADC，官方文档里分别叫ADC1和ADC2。ADC1有8个通道，映射到GPIO32到GPIO39；ADC2有10个通道，映射到GPIO0、GPIO2、GPIO4、GPIO12-15、GPIO25-27。注意：ADC2的通道数虽多，但它和WiFi模块共用一部分模拟前端，所以只要WiFi连接活跃，ADC2的采样结果就不可靠。这个限制在数据手册里写得很明白，但很多人等到“串口打印数值像心电图一样乱跳”时才意识到。

SAR ADC的原理不复杂：内部有一个比较器和电容阵列，逐位逼近输入电压，12位分辨率意味着可输出0~4095的原始码值。但ESP32的ADC和ST/AVR上的ADC有一处显著差异——它的前端等效电阻较高，且输入电容会随采样频率变化。换句话说，ESP32 ADC对信号源内阻非常敏感。如果直接用高阻分压电路（比如几百kΩ电阻分压）接进去，转换结果会明显偏低，而且读数不稳定。

1.2 衰减档位和真实量程

ESP32的ADC输入允许配置衰减（attenuation），常用的是0dB、2.5dB、6dB、11dB四档。衰减越小，能测的电压越低，精度相对越好；衰减越大，量程越宽。很多资料直接把“推荐量程”写成0~2.5V、0~3.6V之类，但实际从曲线图上看，11dB档在1.3V以下时线性度尚可，超过约3.1V（不同芯片有差异）后曲线开始弯曲，最后大约到3.3V左右才饱和。于是就有了一种经验做法：标称量程3.3V，但实际建议只在0~3.0V范围里使用，给非线性部分留出余量。

更准确的做法是先测量几个已知电压点（比如0.5V、1.0V、1.5V、2.0V、2.5V、3.0V），得到原始ADC码值和实际电压的对应表，再做线性或分段校准。ESP32内部有专门存放ADC校准系数的eFuse区，但出厂时部分芯片并没有烧录完整系数，后面我会详细讲。

注意：11dB档不是万能的。如果信号本身在1V以下，选0dB或2.5dB档位能得到更好的低端精度；否则高衰减档的低端曲线同样存在明显偏移。

2. 从硬件设计到驱动配置，一个都不能少

2.1 输入阻抗：比你想的更挑剔

ESP32 ADC对源阻抗敏感，实际测试下来，用10kΩ以下源阻抗，读数偏差较小；用100kΩ以上分压电阻，原始值可能偏低10%甚至更多。因此接电位器、NTC热敏电阻分压时，电阻值不要取得太大。比如NTC测温电路，上拉电阻用10kΩ还能将就，如果换成100kΩ以省电，ADC读数低端会飘，且响应变慢。

解决方案有几种：一是把分压电阻调小，并注意功耗；二是在分压输出与ADC引脚之间加一级运放跟随器，把高阻信号变换成低阻信号；三是用软件多次采样做均值处理，弥补硬件上的不足。要真想拿到稳定读数，前两种才是治本方法，软件均值只能治标。

2.2 GPIO选择与绕开ADC2的WiFi冲突

在项目原理图阶段就应该决定哪些GPIO留给模拟采样。假如你的项目需要同时用WiFi传输数据或做OTA，ADC2通道就不要接任何关键传感器，直接把这些引脚留给数字功能。我做过一个电池电压采集的模块，最初把分压电阻接到ADC2的GPIO12上，结果调试时WiFi一连接，电压读数直接从3.6V跳到1.2V，排查了一晚上才发现是通道冲突。后来换成ADC1的GPIO39，整个世界清静了。

另一个风险是输入电压超限。ESP32的ADC引脚耐压有限，当衰减档位设为0dB时，输入电压超过1.1V附近就会导致读数不再变化，甚至可能损坏引脚。因此设计分压网络时，要确保任意时刻输入到ADC引脚的电压不超过衰减档位对应的安全上限。特别是测量电池电压时，电池空载电压可能短期高于标称值，分压比例需要留出余量。

2.3 关键参数速查与选择建议

从寄存器到驱动，你的选择主要有三组参数：分辨率位宽（12位、11位、10位、9位）、衰减档位、采样次数。ESP-IDF里使用oneshot接口时，分辨率通常固定12位；衰减档位根据量程选择；采样次数由你自己循环调用实现。Arduino下analogRead默认12位，但内部衰减设置与量程相关，需要通过analogSetPinAttenuation设置。

把衰减和量程的选择讲清楚，就能避开大部分“读数不对”的坑。

2.4 一个经典例子：电池电压分压设计的取舍

假设要采集单节锂电池电压，范围3.0V到4.2V。如果直接接到ADC，必须用分压电阻把最高4.2V降到3.0V以内。选择分压比例4.2:3.0，也就是R1=10kΩ串R2=30kΩ，中间抽头接ADC，此时满电电压约为3.15V。这里有两个问题：第一，并联等效阻抗约7.5kΩ，对ESP32 ADC来说还在“勉强可用”的范围；第二，11dB档在这个区间精度不错。如果你希望更稳，可以把两个电阻都缩小到原来的五分之一，等效阻抗降到1.5kΩ，代价是电池静态损耗略有增加。对电池供电设备来说，更要考虑在ADC引脚与地之间加一个100nF电容，既能滤高频噪声，也给输入电容提供电荷源。

3. 实操：ESP-IDF和Arduino双平台实现稳定ADC采样

3.1 ESP-IDF方式：用官方oneshot驱动

ESP-IDF从v5.x开始推荐adc_oneshot组件，代替旧的adc_read接口。使用步骤：先初始化ADC单元和通道，配置衰减与位宽，然后创建读写句柄，最后不断采样。核心代码如下：

#include "esp_adc/adc_oneshot.h" #include "esp_adc/adc_cali.h" #include "esp_adc/adc_cali_scheme.h" adc_oneshot_unit_handle_t adc1_handle; void adc_init(void) { adc_oneshot_unit_init_cfg_t init_cfg = { .unit_id = ADC_UNIT_1, }; adc_oneshot_new_unit(&init_cfg, &adc1_handle); adc_oneshot_chan_cfg_t chan_cfg = { .atten = ADC_ATTEN_DB_11, .bitwidth = ADC_BITWIDTH_12, }; adc_oneshot_config_channel(adc1_handle, ADC_CHANNEL_6, &chan_cfg); // GPIO34 } int adc_read_raw(void) { int raw = 0; adc_oneshot_read(adc1_handle, ADC_CHANNEL_6, &raw); return raw; }

注意ADC_CHANNEL_6对应GPIO34，ADC_CHANNEL_7对应GPIO35；不同开发板上丝印可能不同，用前查一下原理图。上面只是读原始值，要转成电压还需要校准。下面这段代码演示利用官方校准组件读取eFuse系数并换算电压：

adc_cali_handle_t cali_handle; adc_cali_line_cfg_t cali_cfg = { .unit_id = ADC_UNIT_1, .chan = ADC_CHANNEL_6, .atten = ADC_ATTEN_DB_11, .bitwidth = ADC_BITWIDTH_12, }; adc_cali_create_scheme_curve_fitting(&cali_cfg, &cali_handle);

初始化之后，在主循环里调用adc_cali_raw_to_voltage(cali_handle, raw, &voltage_mv)即可得到毫伏值。如果芯片未烧录eFuse校准系数，curve fitting方案可能创建失败，此时需要退回到两点校准方案，或者使用简单的线性映射。

实际用的时候有一个经验：oneshot接口每次调用都会重新配置采样，频繁切换通道会引入额外延迟。如果项目需要多通道采集，建议把通道切换、采样、校准封装成一个独立函数，每次切换后先丢两次读数，等后端电容稳定再取值。

3.2 Arduino方式：快速验证，别直接拿去量产

Arduino环境下读取ADC非常快，两行代码：

analogReadResolution(12); analogSetPinAttenuation(34, ADC_11db); int raw = analogRead(34);

问题在于Arduino core默认的attenuation在某些版本里不是11dB。如果你直接调用analogRead(34)，默认衰减档位和Vref设置可能不符合预期，导致3.3V输入时读不到4095，而是只读到3000左右。所以必须调用analogSetPinAttenuation显式设置衰减档位，同时将analogReference函数与衰减配合使用。为了减小波动，建议在一段采样窗口内多次读取求均值：

int stableRead(int pin, int samples = 16) { int sum = 0; for (int i = 0; i < samples; i++) { sum += analogRead(pin); delay(1); } return sum / samples; }

这里的delay(1)可以给采样电容一点点恢复时间，实测对高阻源有明显改善。需要注意，Arduino环境默认使用VDD3P3作为参考电压，如果板载LDO精度不高，读数会和万用表有偏差。

3.3 实测数据：校准前后的差距到底有多大

我在一块开发板上用可调稳压电源给GPIO34输入电压，用ESP-IDF的curve fitting校准功能读取电压，同时记录原始读数。环境为3.3V供电，衰减档位11dB。典型数据如下表（基于我的测试板实测整理）：

可以看到，在2.0~2.5V区间精度很好，但靠近0.5V和3.2V时误差都会变大。尤其是超过3.1V后，ADC码值几乎不增长，3.2V只比3.0V多了70个码，说明已经到达线性工作范围的边缘。所以如果测量3.3V系统电源电压，11dB档并不合适，应该用分压器把电压降到1.5V左右再用合适的衰减档测量，这样线性度好很多。

4. 常见问题排查：为什么读数总是“不听话”

4.1 数值跳动：先怀疑硬件，再优化软件

出现读数跳变时，不要一上来就堆软件滤波。先查看GPIO是否悬空，悬空状态下ADC读数本来就随机波动；然后检查信号源阻抗，前面提到过高阻抗会极大恶化稳定性。硬件上可以在ADC引脚对地加一个0.1uF到1uF的陶瓷电容，提供电荷注入补偿。软件上采用多次采样取平均，但对快速变化的信号要做取舍，过度滤波会让响应变慢。

经典组合是“16次采样取中值+平均值”：先去掉最大值和最小值，再对剩余14个值求平均。这样对付偶发的尖峰很有效。如果你同时需要高稳定性和一定实时性，4次采样求平均通常比单次采样好得多，且代码量几乎没有增加。

4.2 WiFi开启导致ADC2读数异常

这可能是ESP32社区最经典的问题。原因前面讲了，ADC2与WiFi共用硬件资源，当WiFi以station模式连接路由器后，驱动会占用ADC2相关模拟模块，此时对ADC2的读取会返回错误或随机值。解决办法很简单：模拟采样全部走ADC1，让ADC2只做数字GPIO用途。如果板子上引脚不够用，非要使用ADC2通道，就必须在采样期间暂停WiFi，这会严重影响业务逻辑，不划算。

4.3 校准错误：曲线拟合失败、eFuse系数缺失

创建校准句柄时可能返回不支持，表示当前芯片没有烧录适合的eFuse校准参数。常见于早期的ESP32模组或某些兼容芯片。此时有两种做法：一种是自己制作电压-码值对照表，用最小二乘法拟合一个分段线性函数；另一种直接用公式map(raw, 0, 4095, 0, 3300)计算，要注意这个公式在11dB档下并不准确，误差可达上百毫伏。在需要高精度测量的项目中，建议用外部电压基准生成2到3个已知电压做两点校正，并在代码里保存校正系数。

提醒：不要用万用表直接碰ADC引脚来“校准”，万用表电压档内阻通常10MΩ，不太会影响，但示波器探头负载不能忽略；校准过程中应使用低噪声线性电源作为输入，等电压稳定后再读取数字。

4.4 参考电压和温度漂移的影响

ESP32 ADC的转换是相对于内部参考电压的，而这个参考电压会随着供电电压和温度变化。官方给出的误差包括增益误差和偏移误差，温度漂移大约为每摄氏度若干mV。对高精度项目（比如电池电量百分比、电流传感器），我建议不要依赖内部ADC精度，直接外挂独立16位ADC芯片，通过I2C读取，ESP32只负责通信和计算。对于中等精度项目，可以给ESP32提供一个精确的3.3V LDO，并用它同时作为参考和供电，然后在程序里做一次两点校准。

最后分享一个我自己现在的习惯。温度、电池电压这类缓慢变化信号，我固定用ADC1通道，衰减档位根据量程仔细选，11dB不到万不得已不用；每个采样周期丢前两次数据，再采16次求平均，代码量不大但稳定度提升很明显。如果做的是0.1%级精度的传感器采集，我不会在ESP32内部ADC上死磕，直接外挂独立ADC芯片，省下的调试时间足够覆盖成本。ESP32的ADC其实是“够用但不完美”的典型代表，摸清它的脾气之后，很多看似玄学的问题都能用一句话解释：它终究是个SoC上的附加外设，别用独立ADC芯片的标准去要求它。