STM32 ADC读取B5K电位器：从硬件连接到软件滤波的完整实践指南

1. 项目缘起：从“拧旋钮”到“读电压”的嵌入式入门

最近在整理工作室的物料，翻出来一堆B5K的电位器。这玩意儿在电子爱好者手里简直是“万金油”，从调音量到调亮度，再到各种需要手动调节参数的场合，都能看到它的身影。但很多时候，我们只是把它当作一个简单的分压器，接上电源和地，中间抽头输出一个模拟电压，然后用万用表量一下了事。这其实有点“暴殄天物”了，因为电位器真正的价值在于，它能将一个物理上的旋转或滑动动作，转化为一个可以被微控制器（MCU）精确感知和处理的连续变化的电信号。

这就是我们今天要聊的核心：如何用STM32这颗强大的“大脑”，去“读懂”B5K电位器这个“手指”的动作。听起来很简单，不就是读个ADC（模数转换器）值嘛？但实操过的人都知道，从电路连接、代码配置到数值处理，每一步都有细节。比如，B5K这个阻值有什么讲究？STM32的ADC参考电压怎么选？读回来的值跳动怎么办？怎么把ADC的原始值映射成我们想要的0-100%或者0-360°？这些问题，正是新手从“点灯”迈向“感知世界”的关键一步。

所以，这篇文章就围绕“STM32读取B5K电位器”这个具体任务，掰开揉碎了讲。我会假设你已经有基本的STM32开发环境（比如Keil或STM32CubeIDE），并且会点灯、会用串口打印。咱们的目标是，让你不仅能照着步骤把代码跑起来，更能理解每一步背后的“为什么”，最终能举一反三，把这种读取模拟量的能力应用到自己的项目里，无论是做个调光台灯、遥控小车，还是更复杂的控制系统。

2. 硬件基石：理解B5K电位器与STM32的ADC接口

在写代码之前，我们必须把硬件电路理清楚。硬件是软件的根基，连接错了或者理解有偏差，代码调得再漂亮也是白搭。

2.1 B5K电位器：不只是个“可调电阻”

首先，我们得认清手里的这个“B5K”到底是什么。B5K其实包含了两个关键信息：

  • 5K： 指的是电位器的总电阻值，单位是欧姆（Ω）。也就是说，当你用万用表测量电位器外侧两个引脚（通常标记为1和3）时，阻值应该是5kΩ左右。这个值决定了电位器在电路中的电流消耗。根据欧姆定律I = V / R，在3.3V电压下，流经电位器的最大电流约为0.66mA，对STM32的IO口来说是安全的。
  • B： 这个字母代表了电位器的阻值变化曲线（Taper）。最常见的是B型（线性型）和A型（对数型）。
    • B型（线性）： 阻值的变化与旋转角度（或滑动位移）成线性关系。旋转到中间位置时，中间抽头对两端的电阻比就是1:1。这是我们做参数调节、位置传感时最常用的类型。
    • A型（对数）： 阻值变化与旋转角度的对数成比例，常用于音量调节，以符合人耳对声音响度的感知特性（等响度曲线）。

对于我们读取位置信息的需求，必须使用B型（线性）电位器。如果你用一个A型电位器来当角度传感器，那么读出来的数值和实际角度之间的关系将是非线性的，需要复杂的软件校准，徒增烦恼。

电位器通常有三个引脚。接线时，两端的引脚分别接电源（VCC， 如3.3V）和地（GND）。中间的引脚是滑动抽头（Wiper），它的输出电压V_out会随着旋转而变化，计算公式为：V_out = VCC * (R_bottom) / (R_top + R_bottom)，其中R_bottom是抽头到GND端的电阻，R_top是抽头到VCC端的电阻。当我们旋转电位器时，R_top和R_bottom此消彼长，但总和始终是5kΩ。

2.2 STM32的ADC外设：将模拟世界数字化

STM32内部集成了高精度的ADC（Analog-to-Digital Converter，模数转换器），它的任务就是把电位器抽头上那个连续的电压信号，转换成微控制器能处理的数字值。

这里有几个关键概念需要理解：

  • 分辨率： 常见的STM32的ADC是12位的。这意味着它能把参考电压范围划分成 2^12 = 4096 个等级。每个等级对应一个数字量，从0到4095（或写作0x000到0xFFF）。所以，12位ADC的最小可分辨电压变化=V_ref / 4096。
  • 参考电压（V_ref）： 这是ADC测量的基准。STM32的ADC参考电压源可以来自内部（如VDDA），也可以接外部精密基准源。对于大多数通用应用，我们直接使用芯片的VDDA引脚电压作为参考。务必确保VDDA引脚连接了一个稳定、干净的3.3V电源，并且通常需要在VDDA和VSSA（模拟地）之间就近放置一个1uF和10nF的滤波电容，这是ADC稳定工作的前提。
  • 采样时间： ADC不是瞬间完成转换的，它需要一小段时间来“采样”输入引脚上的电压。对于像电位器这样信号变化相对缓慢的源，我们可以设置较长的采样时间，让ADC内部的采样电容有充足的时间充电到目标电压，从而提高转换精度。STM32允许我们为每个通道独立配置采样时间。

硬件连接示意图：

B5K电位器 引脚1 (VCC端) ----> STM32的3.3V电源 (例如 3V3) 引脚2 (抽头 Wiper) ----> STM32的某个ADC输入引脚 (例如 PA0) 引脚3 (GND端) ----> STM32的GND 注意：STM32的VDDA引脚也必须接3.3V，VSSA接GND。

注意：有些开发板为了简化，已经将VDDA内部连接到3.3V。但为了获得最佳性能，尤其是当你的3.3V电源来自线性稳压器（LDO）时，最好还是按照数据手册要求，独立且良好地处理VDDA/VSSA的供电与滤波。

3. 软件驱动：从CubeMX配置到代码实现

硬件连接妥当后，我们进入软件环节。这里以STM32CubeMX工具配合HAL库为例，这是目前最主流、最快捷的开发方式。即使你用的是标准库或LL库，原理也完全相通。

3.1 使用STM32CubeMX进行图形化配置

  1. 创建工程与选型： 打开CubeMX，选择你使用的具体STM32型号（例如STM32F103C8T6）。
  2. 配置系统核心（SYS）： 在SYS选项卡下，将Debug设置为Serial Wire（如果你要用ST-Link调试）。对于某些型号，如果你计划使用PA15、PB3、PB4等引脚做GPIO，可能需要在这里禁用JTAG功能（选择Disable），释放这些引脚。
  3. 配置时钟（RCC）： 在RCC选项卡下，将HSE（高速外部时钟）设置为Crystal/Ceramic Resonator（如果你的板子有外部晶振）。然后转到Clock Configuration标签页，配置系统时钟（SYSCLK）。对于F1系列，通常用8MHz HSE通过PLL倍频到72MHz。确保给ADC的时钟（ADCCLK）不超过数据手册规定的最大值（例如14MHz）。通常，系统时钟72MHz下，给ADC分频到12MHz或更低是安全的。
  4. 配置ADC引脚：
    • 在芯片引脚图上，找到你计划使用的ADC输入引脚（例如PA0），点击它，选择ADC1_IN0（对于PA0，通常是通道0）。
    • 在左侧分类视图中找到Analog下的ADC1。
    • 在Parameter Settings标签页：
      • Resolution： 选择12-bit。这是精度和速度的平衡。
      • Scan Conversion Mode： 因为我们只用一个通道，选择Disabled。
      • Continuous Conversion Mode： 选择Enabled，这样ADC就会自动连续转换，我们只需要定时去读取结果即可。
      • Discontinuous Conversion Mode：Disabled。
      • DMA Continuous Requests： 如果不用DMA，就Disabled。使用DMA可以大大减轻CPU负担，我们稍后讨论。
      • End Of Conversion Selection： 保持默认。
    • 在NVIC Settings标签页，可以勾选ADC1 and ADC2 interrupts的全局中断。如果使用轮询方式读取，则不需要开启。
  5. 配置ADC通道：
    • 切换到ADC1的Configuration标签页，点击Add按钮添加一个Regular Conversions。
    • 在Rank中，选择Channel 0（对应PA0）。
    • Sampling Time： 这是关键参数！对于电位器这种高阻抗源，建议设置较长的采样时间，以确保采样电容充分充电。可以选择Cycles 239.5或Cycles 480.5（具体选项因型号而异）。时间越长，抗噪声能力越强，但转换速度会变慢。对于手动调节的电位器，速度要求极低，所以选一个较长的周期（如239.5个周期）是很好的选择。
  6. 生成代码： 配置好工程名、路径和工具链（MDK-ARM for Keil）后，点击GENERATE CODE。

3.2 编写应用程序代码

CubeMX生成代码后，我们主要在main.c的/* USER CODE BEGIN */和/* USER CODE END */之间添加业务逻辑。

方案一：轮询方式（最简单）

/* 在main函数初始化部分之后，开启ADC */ HAL_ADC_Start(&hadc1); // 启动ADC连续转换 /* 在main的while循环中 */ while (1) { uint32_t adc_value; if (HAL_ADC_PollForConversion(&hadc1, 100) == HAL_OK) // 等待转换完成，超时100ms { adc_value = HAL_ADC_GetValue(&hadc1); // 获取12位原始值，范围0-4095 // 此时adc_value就是ADC的原始读数 // 可以在这里进行数值映射、滤波或通过串口发送 // 例如，映射到0-100%： // uint32_t percentage = (adc_value * 100) / 4095; } HAL_Delay(50); // 延时一段时间再读，避免过于频繁 }

轮询方式的优缺点：

  • 优点： 代码简单直观，易于理解。
  • 缺点：HAL_ADC_PollForConversion函数会阻塞CPU，直到转换完成或超时。在while循环中频繁调用，会导致CPU大量时间在空等，效率低下，且影响系统实时性。

方案二：中断方式（更高效）

  1. 在CubeMX中启用ADC全局中断（前面已提）。
  2. 在代码中处理中断回调：
/* 在main函数中启动ADC并开启中断 */ HAL_ADC_Start_IT(&hadc1); /* 在main.c文件末尾，用户代码区，重写转换完成回调函数 */ void HAL_ADC_ConvCpltCallback(ADC_HandleTypeDef* hadc) { if (hadc->Instance == ADC1) { uint32_t adc_value = HAL_ADC_GetValue(&hadc1); // 在这里处理adc_value，例如存入全局变量、触发其他操作 // 注意：回调函数中不宜进行耗时操作！ } }

中断方式的优缺点：

  • 优点： 非阻塞。ADC转换完成后自动触发中断，CPU在转换期间可以处理其他任务，效率高。
  • 缺点： 编程稍复杂，需要注意中断服务函数要简短快速。如果转换频率非常高，中断频繁触发，也可能成为系统负担。

方案三：DMA方式（专业之选，强烈推荐）

对于需要连续、高速、稳定采集ADC数据的应用，DMA（直接存储器访问）是终极解决方案。它可以在完全不占用CPU的情况下，自动将ADC转换结果搬运到指定的内存数组中。

  1. CubeMX配置：
    • 在ADC1的Parameter Settings中，将DMA Continuous Requests设置为Enabled。
    • 在Project Manager的Advanced Settings中，确保为ADC1生成了DMA初始化代码。
    • 在DMA Settings标签页（可能在ADC1或System Core下），点击Add，选择ADC1，模式为Circular（循环模式），数据宽度为Word（对应32位，但实际数据是12位右对齐存储的）。
  2. 代码实现：
#define ADC_BUFFER_SIZE 256 // 定义DMA缓冲区大小 uint32_t adc_dma_buffer[ADC_BUFFER_SIZE]; // DMA目标缓冲区 /* 在main函数初始化部分之后 */ HAL_ADC_Start_DMA(&hadc1, (uint32_t*)adc_dma_buffer, ADC_BUFFER_SIZE); /* 此后，adc_dma_buffer数组会被ADC自动、循环地填充 */ /* 在主循环或定时器中断中，你可以直接读取这个数组的最新值或进行平均滤波 */ while (1) { // 例如，取缓冲区中最新的一次转换结果 uint32_t latest_adc_value = adc_dma_buffer[0]; // 注意：在循环模式下，索引0不一定是最新值，需要根据实际情况处理 // 更常见的做法是设置一个“缓冲区已满”的半传输或传输完成中断，在中断中处理一批数据。 HAL_Delay(100); }

DMA方式的优缺点：

  • 优点： CPU零开销。ADC以设定速率连续转换，DMA自动搬运，你可以一次性处理一批数据，非常适合进行数字滤波（如滑动平均）。
  • 缺点： 配置和理解起来最复杂，需要处理缓冲区、指针和可能的中断。

实操心得： 对于读取电位器这种低速应用，轮询方式完全够用，且最简单。但如果你正在学习STM32，我强烈建议你从中断方式开始尝试，然后挑战DMA方式。理解DMA是提升嵌入式开发能力的重要一环。在实际产品中，为了系统稳定性和低功耗，DMA通常是首选。

4. 数据处理：滤波、映射与校准

直接从ADC读回来的原始值（0-4095）往往不能直接使用，因为它带有噪声，并且它代表的是电压，而不是我们最终需要的物理量（如角度、百分比）。

4.1 软件滤波：对抗噪声与抖动

电位器本身有噪声，电源也可能有纹波，导致ADC读数在小范围内跳动。即使电位器静止，读数也可能在±2个LSB（最低有效位）内变化。软件滤波是必须的。

1. 多次采样取平均（最基础有效）：

#define SAMPLE_TIMES 16 // 采样次数，必须是2的幂次，方便用移位代替除法 uint32_t read_adc_average(void) { uint32_t sum = 0; for(int i=0; i<SAMPLE_TIMES; i++) { // 假设使用轮询方式单次读取函数为 read_adc_once() sum += read_adc_once(); HAL_Delay(1); // 每次采样间隔一小段时间 } return (sum / SAMPLE_TIMES); // 或使用 sum >> 4 (因为16是2的4次方) }

2. 滑动平均滤波（更适用于连续采样）： 适用于DMA方式连续采集的场景。维护一个固定长度的队列（数组），每次新数据进来，替换掉最老的数据，然后计算队列中所有数据的平均值。

#define FILTER_WINDOW_SIZE 8 uint32_t adc_filter_buffer[FILTER_WINDOW_SIZE] = {0}; uint8_t filter_index = 0; uint32_t sliding_average_filter(uint32_t new_value) { uint32_t sum = 0; adc_filter_buffer[filter_index] = new_value; // 新值替换旧值 filter_index = (filter_index + 1) % FILTER_WINDOW_SIZE; // 索引循环 for(int i=0; i<FILTER_WINDOW_SIZE; i++) { sum += adc_filter_buffer[i]; } return sum / FILTER_WINDOW_SIZE; }

3. 一阶低通滤波（惯性滤波）： 这种方法模拟了硬件RC低通滤波器的效果，计算量小，能很好地平滑数据。

float alpha = 0.2; // 滤波系数，0<alpha<1，越小越平滑，但响应越慢 float filtered_value = 0; uint32_t low_pass_filter(uint32_t new_value) { filtered_value = filtered_value + alpha * (new_value - filtered_value); return (uint32_t)filtered_value; }

注意事项： 滤波在平滑噪声的同时，也会引入滞后（延迟）。对于电位器这种手动操作，滞后几十毫秒到一百毫秒人眼几乎无法察觉，所以可以大胆使用较强的滤波（如大的窗口或小的alpha）。但如果是用于高速反馈系统，就需要在平滑度和响应速度之间仔细权衡。

4.2 数值映射：从ADC值到有用信息

滤波后的稳定ADC值，需要映射成有意义的物理量。

1. 线性映射到百分比（0-100%）： 这是最常见的需求，比如控制PWM占空比、设置阈值等。

uint32_t adc_raw = read_adc_filtered(); // 假设这是滤波后的值，0-4095 uint32_t percentage = (adc_raw * 100) / 4095; // 注意：先乘后除，避免整数运算归零

2. 线性映射到特定范围（如0-360°）： 假设电位器是单圈旋转型（通常300°有效电气角度），我们可以映射到角度。

#define ADC_MIN 80 // 实测得到的最小ADC值（对应0°） #define ADC_MAX 4000 // 实测得到的最大ADC值（对应300°） uint32_t angle = (adc_raw - ADC_MIN) * 300 / (ADC_MAX - ADC_MIN); if(angle > 300) angle = 300; // 限幅 if(angle < 0) angle = 0;

3. 非线性校正： 如果你的电位器线性度不好，或者你需要一个特殊的响应曲线（如指数音量调节），可以查表法（LUT）。预先测量一组ADC值和目标输出值的对应关系，存入数组。使用时，根据当前ADC值，在表中查找最近的两个点进行线性插值，得到最终输出。这对于高精度应用或校正传感器非线性非常有效。

4.3 校准：消除硬件误差

理想情况下，电位器拧到一端是0V（ADC值0），拧到另一端是3.3V（ADC值4095）。但现实很骨感：

  • 硬件公差： 电位器两端可能无法接触到真正的端点电阻。
  • 参考电压误差： VDDA可能不是精确的3.300V。 因此，上电校准或手动校准是提升精度的好习惯。

简单的两点校准法：

  1. 上电后，提示用户将电位器拧到最小值位置，然后按下一个“校准键”。
  2. 单片机连续采样一段时间，记录下稳定的ADC值，作为adc_min。
  3. 提示用户将电位器拧到最大值位置，再次按下校准键。
  4. 记录稳定的ADC值，作为adc_max。
  5. 后续所有的映射计算，都使用adc_min和adc_max作为范围，而不是理论上的0和4095。
uint32_t map_calibrated(uint32_t adc_raw, uint32_t cal_min, uint32_t cal_max, uint32_t out_min, uint32_t out_max) { if(adc_raw <= cal_min) return out_min; if(adc_raw >= cal_max) return out_max; // 防止除零 if(cal_max == cal_min) return out_min; return ( (adc_raw - cal_min) * (out_max - out_min) / (cal_max - cal_min) + out_min ); }

5. 进阶优化与问题排查

把基本功能跑通只是第一步，要让项目更稳健、更专业，还需要考虑以下方面。

5.1 电源与参考源的稳定性

ADC的精度极度依赖参考电压的稳定性。如果系统的3.3V电源是从USB的5V通过LDO（如AMS1117-3.3）降压得来，当数字部分（如LED、电机）工作时，会引起电源纹波，导致ADC读数波动。

  • 对策一： 为模拟部分（VDDA）使用独立的LDO供电，或者至少使用LC（电感-电容）滤波器从数字电源中隔离出模拟电源。
  • 对策二： 使用STM32内部的参考电压缓冲器（如果型号支持）。它可以提供一个更稳定的内部参考电压给ADC。
  • 对策三： 软件上，可以采集一个已知的、稳定的内部参考电压（如内部带隙电压VREFINT），通过比例计算来抵消VDD变化的影响。STM32的HAL库提供了HAL_ADCEx_Calibration_GetValue等函数来辅助此过程。

5.2 多通道采集与扫描模式

如果你需要读取多个电位器，不必为每个电位器配置一个ADC。STM32的ADC支持多通道扫描。

  1. 在CubeMX中，为多个引脚（如PA0, PA1, PA2）配置ADC通道。
  2. 在ADC1的Parameter Settings中，将Scan Conversion Mode设置为Enabled。
  3. 在Configuration的Regular Conversions中，按顺序添加多个Rank，每个Rank对应一个通道，并设置好采样时间。
  4. 使用DMA方式启动转换。DMA的目标缓冲区需要是一个数组，其长度等于通道数。ADC会按照Rank顺序自动转换每个通道，结果依次存入DMA缓冲区。
  5. 读取时，缓冲区adc_dma_buffer[0]是第一个通道的值，adc_dma_buffer[1]是第二个通道的值，以此类推。

5.3 常见问题与排查思路

  • 问题：ADC读数始终为0或4095。
    • 排查： 首先用万用表测量电位器抽头的电压，看是否在0-VCC之间正常变化。如果电压正常，检查STM32的ADC引脚配置是否正确（是否配置为模拟输入模式Analog）。检查VDDA和VSSA是否已正确连接。
  • 问题：ADC读数跳动很大，即使电位器不动。
    • 排查：
      1. 硬件： 检查电源纹波。用示波器看VDDA和ADC输入引脚上的波形。确保电位器抽头与ADC引脚之间的连线短且牢固。在ADC输入引脚到地之间加一个10nF - 100nF的陶瓷电容，可以很好地滤除高频噪声。
      2. 软件： 增加ADC采样时间（Sampling Time）。这是对付高阻抗信号源噪声最有效的软件手段。其次，实施软件滤波（如前面所述的滑动平均）。
  • 问题：读数范围不全，达不到0或4095。
    • 排查： 这是正常现象，由电位器的端点电阻和PCB走线电阻导致。使用前面介绍的两点校准法即可完美解决，无需纠结硬件。
  • 问题：使用DMA时，数据好像不对或溢出。
    • 排查： 检查DMA缓冲区大小是否足够。在循环模式下，ADC会一直写，如果CPU读取速度跟不上，新数据会覆盖旧数据。可以考虑使用DMA的“半传输完成”和“传输完成”中断，在中断中处理半缓冲或全缓冲数据，这是更可靠的双缓冲机制。另外，检查DMA的数据宽度（Word）和ADC的数据对齐方式（通常为右对齐Right alignment）是否匹配。

6. 项目实战：构建一个可调光LED灯

理论最终要服务于实践。让我们用一个简单的综合项目来串联所有知识点：用B5K电位器控制一个LED的亮度。

硬件清单：

  • STM32最小系统板 x1
  • B5K线性电位器 x1
  • LED灯珠（或开发板上的用户LED） x1
  • 220Ω限流电阻 x1（如果LED没有内置）
  • 杜邦线若干

电路连接：

  1. 电位器两端接3.3V和GND，抽头接PA0（ADC）。
  2. LED正极通过220Ω电阻接PB0（或其他GPIO），负极接GND。

软件设计：

  1. CubeMX配置：
    • 配置PA0为ADC1_IN0。
    • 配置PB0为GPIO_Output（推挽输出，低电平有效取决于你的LED接法）。
    • 配置一个定时器（如TIM2），用于产生PWM信号。将PB0映射为该定时器的PWM输出通道（如TIM2_CH3）。
    • 配置ADC（12位，连续转换，长采样时间）。
    • 生成代码。
  2. 代码逻辑：
    • 在main函数中，启动ADC（轮询或中断方式），启动PWM定时器。
    • 在while循环或ADC中断回调中，读取滤波后的ADC值。
    • 将ADC值（0-4095）线性映射到PWM的占空比设置值（如0-1000，对应0%-100%）。
    • 更新PWM的占空比寄存器（如__HAL_TIM_SET_COMPARE(&htim2, TIM_CHANNEL_3, duty_cycle)）。
  3. 效果： 旋转电位器，LED的亮度会平滑地变化。通过调整软件滤波参数，你可以让亮度变化非常平滑，毫无闪烁感。

这个项目虽然小，但它完整地实践了模拟信号采集（ADC）、数字信号处理（滤波、映射）和模拟信号输出（PWM）的闭环。理解了它，你就掌握了嵌入式系统与物理世界交互的一项核心技能。你可以轻易地将它扩展为控制电机转速、舵机角度、蜂鸣器音调等等。