简介：低功耗 STM32L0x1 ADC 示例程序包，面向基于 ARM Cortex-M0+ 超低功耗 MCU 的模拟量采集场景，适合电池供电的物联网节点、传感器数据采集项目，也适合想掌握低功耗外设配置的嵌入式开发者。压缩包约 4.6MB，共 178 个文件，包含 .h/.c 源文件、Keil/STM32CubeIDE 工程配置、编译生成的 .o/.axf 与 .map 文件，以及启动文件、链接脚本和 .ioc 配置，其中 LL 库驱动代码覆盖 ADC、RTC、TIM、USART、DMA 等外设，可直接导入工程并观察编译链接流程。示例代码演示了 ADC 多通道初始化、单次/连续/扫描转换、中断读取结果、校准滤波等关键流程，并包含了 12 位分辨率与采样率配置示例，同时针对性安排了低功耗模式下的电源管理策略，覆盖从数据采集到功耗控制的完整链路。已有 295 人学习下载，初学者能按步骤理解 STM32L0 的 ADC 操作，中高级开发者可将其作为低功耗模拟量采集的快速移植模板。
1. 低功耗 ADC 工程拆解：为什么 STM32L0x1 要单独处理时钟和校准
拿到这份低功耗 STM32L0x1 ADC 程序包时，我第一个反应是看它怎么处理三件事：停止模式下的时钟保持、采样时钟分配、转换结果校准。STM32L0x1 这颗芯片在低功耗场景里用 ADC，跟在开发板上随便点两下就跑完全是两回事，很多环节写错了也能正常编译，但量出来的数据就是不对。这份程序把完整链路都给了出来，从 RCC 时钟源切换到底层转换和唤醒流程都有对应代码，不是数据手册里抠出来的一页两页示例。它适合做电池供电传感器、便携仪表和低功耗数据采集器的工程师直接拿来改，也适合第一次接触 L0 低功耗模式的人理解“省电和精度怎么同时成立”。下面我会按底层逻辑、代码拆解、运行验证、避坑这条线把资源讲透。
2. 低功耗模式下 ADC 的底层逻辑：时钟、参考电压与采样时间的三角关系
STM32L0x1 这颗芯片和常见的 F1 系列有一个明显的不同：ADC 的时钟并不强制挂在 APB 总线的 PCLK 上，而是可以从独立时钟源里选。这个特性在低功耗场景下价值很大。进入停止模式后，CPU、SRAM、大部分总线时钟都会被关掉，如果你还指望 ADC 在唤醒瞬间立刻工作，就必须选一个不随系统一起掉电的时钟源。所以拆这份程序前，我建议先把 ADC 时钟路径、参考电压来源和采样时间三个点放在一起看。
2.1 时钟源选型：为什么低功耗场景要优先选 HSI16 而不是 PCLK
L0 系列内部有一个约 16 MHz 的 RC 振荡器，叫 HSI16。它最大的特点是能独立于系统主时钟运行，并且在部分低功耗模式下仍保持输出。当你把 ADC 时钟直接接在 PCLK 上时，遇到的情况会是这样：进停止模式后 PCLK 停了，ADC 也跟着断电；等外部事件唤醒 CPU，内核时钟开始恢复，但 ADC 模块重新上电后还要等内部电路稳定，第一次转换往往拿到的是废数据。很多开发者在低功耗项目里遇到“唤醒后第一笔采样异常”的问题，根源就在这。
常见做法是让 HSI16 作为 ADC 的采样时钟，这样 ADC 在 CPU 睡眠甚至停止模式下依然有稳定的时钟来源。但这里有一个容易漏掉的细节：HSI16 保持使能和 HSI16 作为 ADC 时钟源是两件事。前者由 RCC 的振荡器配置决定，后者要在外设时钟配置里单独把 ADC 的时钟选择位切到 HSI16。只做了其中一步，就会出现“休眠正常、唤醒后数据跳动”的玄学现象。下面是一段典型的 RCC 配置写法：
RCC_OscInitTypeDef RCC_OscInitStruct = {0}; RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSI16; RCC_OscInitStruct.HSI16State = RCC_HSI16_ON; RCC_OscInitStruct.HSI16CalibrationValue = RCC_HSI16_CALIBRATION_DEFAULT; HAL_RCC_OscConfig(&RCC_OscInitStruct); RCC_PeriphCLKInitTypeDef PeriphClkInit = {0}; PeriphClkInit.PeriphClockSelection = RCC_PERIPHCLK_ADC; PeriphClkInit.AdcClockSelection = RCC_ADCCLKSOURCE_HSI16; HAL_RCC_PeriphCLKConfig(&PeriphClkInit);逻辑说明：第一段先把 HSI16 打开，并设定使用出厂默认校准值；第二段把 ADC 的时钟源从 PCLK 切换到 HSI16。如果不做第二段，ADC 还会继续从 PCLK 取时钟，那第一段等于白配。
参数说明：RCC_HSI16_CALIBRATION_DEFAULT 表示用芯片出厂时的校准值，一般情况下不要手动改，除非你手上有更高精度的时钟源需要做微调。AdcClockSelection 在部分型号的库函数里可能是 RCC_ADCCLKSOURCE_HSI16 或类似枚举值，具体以芯片头文件为准。这里的关键点不是记宏名，而是理解“ADC 时钟和 CPU 时钟是两条独立路径”。
2.2 参考电压：VDDA 直连与 VREFINT 自校正的价值
ADC 转换本身是一个比例运算：输入电压除以参考电压，再乘以满量程。STM32L0x1 的默认参考电压就是 VDDA，芯片的模拟供电引脚。问题在于，电池供电设备的 VDDA 不会永远稳定在 3.3V。锂电池从 4.2V 放到 3.0V，这段时间里同样一个传感器电压，测出来的原始码会一直变，而且变化方向和电池电压完全一致。这时候如果直接拿 3.3V 当参考电压去算，误差会非常明显。
对策一种是外接精密基准芯片，把 VREF+ 引脚拉到一个稳定的参考电压上。精度高，但占板子和成本，适合千分之一精度以上的仪器。另一种是低功耗设备里常用的做法：用芯片内部集成的 VREFINT 参考电压通道做自校正。VREFINT 是一个内部基准源，出厂时测过并保存了校准值，把它当一个 ADC 通道来采样，可以反推出当前真实 VDDA 是多少。反推公式的思路是：内部参考电压的典型值已知，比如 1.2V 左右，那么用 ADC 量这个内部参考电压得到的原始码，就能倒推 VDDA。真实 VDDA 等于 4096 乘以参考电压典型值，再除以 VREFINT 通道的原始码。
代码上 VREFINT 通道的采样可以这样写：
ADC_ChannelConfTypeDef sConfig = {0}; sConfig.Channel = ADC_CHANNEL_VREFINT; sConfig.Rank = ADC_REGULAR_RANK_1; sConfig.SamplingTime = ADC_SAMPLETIME_64CYCLES_5; HAL_ADC_ConfigChannel(&hadc1, &sConfig); HAL_ADC_Start(&hadc1); HAL_ADC_PollForConversion(&hadc1, 10); uint16_t raw_vref = HAL_ADC_GetValue(&hadc1); float vdda = 4096.0f * 1.224f / (float)raw_vref;逻辑说明：raw_vref 是 VREFINT 通道的 ADC 原始值，范围在 0 到 4095。代码先用较长采样时间把内部参考电压的量稳定下来，再反推 VDDA。
参数说明：1.224f 是 VREFINT 典型值，不同批次芯片会有微小差异，所以更严谨的做法是读取系统存储器里出厂校准值来替代这个常数。用长采样时间是因为内部基准源有缓冲器，采样时间太短的话，缓冲器没稳定，测出来的 VREFINT 数值本身就会抖。VREFINT 每次上电最好都重新采一次，不要只采一次存全局变量用到底，因为温度变化会让它轻微漂移。
2.3 采样时间：高阻抗信号源下最容易被低估的功耗漏洞
采样时间决定了 ADC 内部采样电容的充电窗口。如果信号源阻抗高，比如从 100kΩ 分压电阻网络取电压，采样时间太短会导致电容没充满，测出来数值偏低。表现就是同一个电压，把采样时间从 16 个周期改成 64 个周期，读数明显上升，最后稳定在某个值。这不是芯片坏了，是充电时间不够。
但低功耗场景里不能无脑拉长采样时间。采样窗口内 ADC 的功耗是持续发生的，把采样周期从 16 拉长到 64，单次转换的能量消耗会明显上涨。对高频采样场景来说，这个上涨直接影响整机平均功耗。我的做法是先评估信号源等效输出阻抗。如果输出阻抗控制在 10kΩ 以内，采样时间用 16 周期通常够用；如果前端有高阻分压网络，直接用 32 或 64 周期，别在这里为了省几个微安的瞬时电流，牺牲整条数据链路的可信度。
还有一个多通道扫描时的隐藏问题：采样时间参数是按通道独立配置的，不存在一个全局采样时间通吃所有通道。外部传感器通道和 VREFINT 通道如果各需要不同采样时间，就要分别配置并在代码注释里写清楚。我看到过太多例子，工程师调完外部通道看数据正常，就忘了 VREFINT 通道的采样时间还是初始值，结果 VDDA 反推出来一塌糊涂。
3. 程序是怎么组织起来的：从初始化结构体到停止模式唤醒
这份工程的核心模块并不复杂，按功能可以分成三块：ADC 初始化、采样通道配置、低功耗唤醒与转换流程。下面先看最基础的初始化部分，这部分决定 ADC 整体的工作模式。
3.1 初始化结构体逐行拆解：从预分频到校准
STM32L0 系列的 ADC 初始化，用的是 HAL 库的 ADC_InitTypeDef 结构体。这份工程里设置的是一个单通道、12 位分辨率、软件触发的模式，用于从停止模式唤醒后做一次快速采样。代码如下：
void ADC1_Init(void) { ADC_ChannelConfTypeDef sConfig = {0}; __HAL_RCC_ADC1_CLK_ENABLE(); hadc1.Instance = ADC1; hadc1.Init.Clock = ADC_CLOCK_ASYNC; hadc1.Init.Resolution = ADC_RESOLUTION_12B; hadc1.Init.DataAlign = ADC_DATAALIGN_RIGHT; hadc1.Init.ScanConvMode = ADC_SCAN_DISABLE; hadc1.Init.EOCSelection = ADC_EOC_SINGLE_CONV; hadc1.Init.LowPowerAutoWait = ENABLE; hadc1.Init.LowPowerAutoPowerOff = DISABLE; hadc1.Init.ContinuousConvMode = DISABLE; hadc1.Init.NbrOfConversion = 1; hadc1.Init.DiscontinuousConvMode = DISABLE; hadc1.Init.ExternalTrigConv = ADC_SOFTWARE_START; if (HAL_ADC_Init(&hadc1) != HAL_OK) { Error_Handler(); } sConfig.Channel = ADC_CHANNEL_4; sConfig.Rank = ADC_REGULAR_RANK_1; sConfig.SamplingTime = ADC_SAMPLETIME_16CYCLES; if (HAL_ADC_ConfigChannel(&hadc1, &sConfig) != HAL_OK) { Error_Handler(); } HAL_ADCEx_Calibration_Start(&hadc1); }逻辑说明：Clock 字段选 ASYNC，表示 ADC 使用独立时钟源而不跟随 APB 总线；LowPowerAutoWait 打开后，ADC 会在转换完成后暂停等待，避免不断自动启动造成功耗浪费；校准放在所有通道配置完成后、首次转换开始前，用来修正芯片内部比较器的偏移误差。
参数说明：12 位分辨率对应的原始值范围是 0 到 4095。采样时间选了 16 个周期，适合源阻抗不太高的场景。如果直接接的是传感器输出而不是分压电阻，可以先用 16 周期跑一遍，看数据稳定性再决定是否加长。NbrOfConversion 设为 1 表示规则组里只有这一个通道，如果后面要加通道，这里要同步改。
3.2 停止模式下的采样流程：唤醒、转换、再睡死
低功耗设备典型的工作节奏是：大部分时间待在停止模式，由 LPTIM 或 RTC 定时器唤醒，完成一次 ADC 采样后立刻睡回去。这个循环里最容易出问题的是唤醒后系统时钟的恢复。停止模式下关闭的是系统主时钟，重新醒来后需要先恢复时钟配置，再启动 ADC，否则外设拿到的是一个不稳定的时钟状态。
下面这段伪代码体现了完整的低功耗采样流程：
void LowPower_Sample_And_Sleep(uint32_t sleep_ms) { /* 1. 唤醒后先恢复系统时钟 */ SystemClock_Config(); /* 2. 单次 ADC 转换 */ HAL_ADC_Start(&hadc1); HAL_ADC_PollForConversion(&hadc1, 100); uint16_t raw = HAL_ADC_GetValue(&hadc1); HAL_ADC_Stop(&hadc1); /* 3. 数据保存后进入停止模式 */ g_last_raw = raw; HAL_PWR_EnterSTOPMode(PWR_MAINREGULATOR_ON, PWR_STOPENTRY_WFI); /* 4. 从 WFI 返回后，系统时钟已停止，需重新初始化 */ SystemClock_Config(); }逻辑说明：HAL_PWR_EnterSTOPMode 之后，代码停在 WFI 等待中断。发生唤醒事件后，下一条语句开始执行，但此时系统时钟还没恢复，所以紧接着就要调 SystemClock_Config。如果省略这一步，ADC 还能启动，但时序全乱，采样值不可信。
参数说明：PWR_MAINREGULATOR_ON 表示进入停止模式时保持主电压调节器开启，退出延迟短，适合需要快速响应的场景。PWR_STOPENTRY_WFI 指定用 WFI 指令进入停止，系统会在中断到来时自动唤醒。LPTIM 配置的是定时采样周期，我这里习惯把它做成一个可调参数，比如 1 秒或 10 秒，具体取决于应用对数据实时性的要求。
4. 把工程跑起来：时钟参数速查、串口打印与实测数据判读
代码能编译只是第一步，真正让数据变得可用，还需要把时钟参数调对、把原始码正确换算成物理量，并学会从串口输出判断链路是否健康。
4.1 时钟与功耗参数速查表
这份工程里最核心的配置项，我整理成一个速查表，方便直接对照。第一次接触 L0 低功耗 ADC 的人，可以先按这个表设置，再根据实际需求微调。
| 配置项 | 推荐值 | 说明 |
|---|---|---|
| 系统时钟源 | MSI 2.1MHz 或 4.2MHz | 唤醒后执行采样绰绰有余，不必拉满主频 |
| ADC 时钟源 | HSI16 | 停止模式下仍可保持独立的时钟信号 |
| ADC 采样频率 | HSI16 四分频，约 4MHz | 兼顾功耗与采样速度 |
| 采样时间 | 16 到 64 周期 | 低阻抗源用 16，高阻抗源用 32 以上 |
| ADC 分辨率 | 12 位 | 原始值范围 0 到 4095 |
| 参考电压 | VDDA | 电池电压，用量 VREFINT 反推实际值 |
| 停止模式唤醒源 | LPTIM 或 RTC | 按采样率需求设定唤醒周期 |
| 转换触发方式 | 软件触发 | 适合唤醒后单次采样 |
这里要特别提一下采样频率和功耗的关系。HSI16 给到 ADC 的时钟越高，单位时间内的动态功耗越大，但单次转换时间越短。对低功耗设备来说，单次转换时间短意味着 ADC 的活跃窗口小，整体平均功耗反而可能更低。所以不要一味追求低 ADC 时钟，要根据采样频率来平衡。慢速采样场景下，4MHz 是一个稳妥的起点。
4.2 串口打印与真实电压换算
ADC 拿到的是 0 到 4095 的原始码，不能直接把原始码当电压值上报。换算公式是电压等于原始码除以 4096，再乘以参考电压 VDDA。但 VDDA 是电池电压，会随着电量变化，所以更可靠的做法是用 VREFINT 反推出实际 VDDA，再代入换算。代码示例如下：
uint16_t raw_ch = HAL_ADC_GetValue(&hadc1); /* 目标通道原始值 */ float voltage = (float)raw_ch * vdda / 4096.0f; printf("raw=%d, vdda=%.3fV, voltage=%.3fV\r\n", raw_ch, vdda, voltage);逻辑说明：vdda 来自 VREFINT 通道反推结果。转换公式本身没有玄学，真正的误差来源是参考电压是否准确。如果你直接硬编码 VDDA 等于 3.3V，而电池实际已经掉到 3.0V，算出来的电压整体偏低百分之十，这在电量监测场景里是不可接受的。
参数说明：printf 在低功耗代码里要谨慎使用，因为标准库的 printf 实现可能比较重。如果用的单片机内存小，建议用轻量化的 printf 重定向或直接把原始码通过串口十六进制上传，由上位机做换算。
4.3 打印数据判读：三类异常输出的排查方向
串口打印出来的数据，能帮你在不上调试器的情况下快速定位问题。最常见的三种情况如下。
第一种，数值持续为 0。大概率是通道根本没通。检查 GPIO 是否配成模拟模式，检查通道编号是否对应正确的引脚，检查外部电路是否有信号。我在调试 PA4 通道时曾经把通道号错写成 ADC_CHANNEL_5，编译不报错，但读回来的数据永远是 0，花了不少时间才定位到。
第二种，数值持续在 4095 或接近 4095。说明输入电压接近或超过了参考电压，也可能引脚悬空导致浮空电平被拉高。这时候用万用表量一下引脚对地电压，能很快区分是电路问题还是配置问题。
第三种，数值来回飘，同一条件下每次转换相差几十个 LSB。先确认采样时间是否太短，然后确认供电是否稳定，最后查一下 PCB 上 ADC 引脚周围有没有高频信号干扰。有些时候是线路板清洗不干净，引脚间有助焊剂残留导致漏电，这在小批量样品阶段特别容易出现。
5. 低功耗 ADC 避坑记录：五个典型翻车现场及根因与修复
这章放在最后其实不太合理，因为拆这块工程时，真正折磨人的通常不是配置本身，而是那些看着能跑但数据不对的问题。下面直接上五条记录，每条按现象、原因、解决来写，省得你再踩一遍。
5.1 转换值整体偏移 5% 以上
现象：同一个输入电压，测出来比万用表偏低或偏高二三十毫伏，而且随着温度变化偏移量还会变。
原因：初始化时没有执行 ADC 校准。L0 的 ADC 内部有比较器失调，出厂校准值需要通过校准流程加载。漏掉这步，芯片也能出数，但精度会明显退化。
解决：在首次转换前调用校准函数。这份工程里的 HAL_ADCEx_Calibration_Start 就是干这个的。注意校准要在 ADC 上电后、未开始转换前执行，顺序错了校准结果无效。环境温差大的设备，建议每隔一段时间或每次从停止模式返回后重新校准，代价只是几十微秒时间。
5.2 停止模式唤醒后 ADC 卡死或首笔数据无效
现象：程序进入停止模式后再唤醒，ADC 转换始终停在 BUSY 状态，或拿到的第一个数据明显不合理。
原因：ADC 的时钟源选了 PCLK，而停止模式下 PCLK 已经消失。ADC 没有时钟就无法完成转换，等系统时钟恢复后它也可能处于一个中间状态。
解决：把 ADC 时钟切到 HSI16，同时确保 HSI16 在停止模式下保持开启。代码上的落点是 2.1 节里的 RCC_PeriphCLKConfig 配置，以及时钟初始化时对 HSI16 状态的控制。还有一个习惯很管用：唤醒后先恢复系统时钟，再启动 ADC，别反过来。
5.3 全 0 或全满码数据，伴随通道异常
现象：ADC 读到的数值要么是 0，要么是 4095，完全没有中间过渡，而且换通道后症状不变。
原因：多数情况下不是 ADC 坏了，而是 GPIO 没配置成模拟模式。数字模式下引脚内部有上下拉电阻，电平被钳住，模拟信号进不来。另一个常见原因是通道使能顺序有问题，或者引脚被复用成其它外设功能。
解决：优先检查 GPIO 初始化，确认使用 GPIO_MODE_ANALOG 模式，而不是复用模式。再用示波器或万用表量引脚电压，确认引脚上确实有模拟信号。代码层面确认通道编号和引脚映射一致。这三步按顺序走一遍，基本能定位。
5.4 同一稳定电压下采样值跳动明显
现象：输入电压很稳定，但 ADC 每次转换结果都有几十 LSB 甚至更多的波动，采样时间改了之后波动幅度有明显变化。
原因：采样时间不足是首要嫌疑。信号源输出阻抗较高时，内部采样电容还没充满就开始转换，结果就会带着随机性。其次是 VREFINT 反推 VDDA 时，参考电压测量本身就引入了噪声，两边误差叠加。
解决：先把目标通道采样时间从 16 周期提高到 32 或 64 周期，看波动是否收敛。然后单独打印 VREFINT 通道的原始值，确认它是否稳定。如果 VREFINT 都跳，问题大概率在电源噪声或 PCB 基准走线。必要时在 ADC 输入引脚对地并联一个 1nF 到 10nF 的电容，能滤掉一部分高频噪声，但这会增加源阻抗的充电时间，采样时间也要相应加长。
5.5 DMA 模式下第一个数据是旧数据
现象：开了 DMA 连续采样，平均滤波后结果看着正常，但单步调试时发现 buffer 的第一个值总是上一次采样的残留，导致整组数据里含一个野值。
原因：DMA 和 ADC 的启动时序没有对齐。DMA 在 ADC 产生第一个转换完成事件之前就已经就绪，或者上一次 DMA 传输完成后没有清理标志位，残留数据被保留下来。
解决：启用 DMA 前先清理对应 DMA 通道的标志，然后先启动 ADC，再启动 DMA。或者用 ADC 的 DMA 请求信号来控制传输时序。还有一个笨办法但有效：舍弃 buffer 里的第一个数据，从第二个开始处理。这个做法在数据量足够时成本很低，实测能避免百分之九十的首数据野值问题。
__HAL_DMA_CLEAR_FLAG(&hdma_adc1, DMA_FLAG_TC | DMA_FLAG_HT | DMA_FLAG_TE); HAL_ADC_Start_DMA(&hadc1, (uint32_t *)adc_buf, 16);逻辑说明：清标志后，DMA 处于干净状态，再启动 DMA 传输，避免旧标志触发错误的中断或错误的传输表现。DMA 与 ADC 的配合，在低功耗场景里通常用于批量采样后一次性运算。
参数说明：adc_buf 是存放原始码的 uint16_t 数组，长度 16 表示一次连续采 16 个点。DMA 传输完成后会触发回调，在回调里做均值滤波即可。
6. 进阶：DMA 批量采样的均值滤波与功耗验证技巧
单次采样的数据波动如果没法通过硬件调整完全消除，可以用软件手段补救。STM32L0x1 的 ADC 支持 DMA 搬运，配置成固定长度连续采样后，直接对数组做均值滤波。这比把单次采样结果交给上层做算法要省心得多，而且几乎不增加 CPU 负载。用一个全局数组接收 16 个采样点，等 DMA 传输完成中断里累加求平均值，得到的就是一个明显更稳定的结果。
static uint16_t adc_buf[16]; void HAL_ADC_ConvCpltCallback(ADC_HandleTypeDef *hadc) { if (hadc->Instance == ADC1) { uint32_t sum = 0; for (int i = 0; i < 16; i++) { sum += adc_buf[i]; } g_adc_average = sum / 16; } }逻辑说明：这相当于一个 16 点移动平均滤波器，能显著压低随机噪声，但对系统性偏差没有作用。所以校准和采样时间的检查不能省。
参数说明：数组长度 16 是一个折中值。对缓慢变化的模拟量，16 个点足够；对快速变化的信号，会引入一些延迟。如果应用对响应速度敏感，可以把长度降到 8 或 4。
功耗验证也有一个不用专业设备的小技巧。在系统供电回路里串一个 10Ω 采样电阻，用示波器观测电阻两端压降，通过压降波形能看出每个采样周期内电流的变化。低功耗设备睡眠时预期电流在微安级别，压降几乎为零；唤醒瞬间电流尖峰会在示波器上形成一个明显的脉冲，脉冲宽度就是活跃窗口时间。测量时注意示波器探头要使用差分方式，避免参考地干扰。把多个周期的波形叠加起来，用示波器的平均模式计算一个周期的平均功耗，这个值比单纯看万用表更真实。从那以后，我每次发版前都会强制走三步自查：确认 ADC 时钟挂在 HSI16、重新执行校准、核对采样时间与信号源阻抗匹配。这三步做完，低功耗 ADC 项目基本不会再出现“睡眠被拖垮”或者“数据莫名漂移”的返工。希望帮到你。
本文还有配套的精品资源，点击获取
