1. 项目概述从模拟信号到数字温度的旅程在嵌入式开发尤其是基于STM32这类微控制器的项目中采集物理世界的模拟信号是一项基础且核心的任务。温度作为最常见的环境参数之一其采集过程完美地诠释了从模拟到数字的转换逻辑。这个项目标题“STM32 Cubemx 使用AD转换获取温度值”看似简单实则串联了硬件选型、外设配置、软件驱动和数据处理一整条链路。它不仅仅是配置一个ADC模数转换器通道那么简单更是理解嵌入式系统如何感知世界的第一步。对于刚接触STM32的开发者CubeMX这个图形化配置工具极大地降低了入门门槛让你无需深究底层寄存器就能快速搭建工程框架。但“获取温度值”这个目标要求我们更进一步你需要连接一个温度传感器如常见的NTC热敏电阻或集成芯片LM35理解其电气特性正确配置ADC的采样时间、分辨率并编写代码将ADC读取到的原始数字量通过特定的公式或查表法转换为直观的温度值。这个过程充满了细节从参考电压的稳定性到软件滤波算法的选择每一个环节都可能影响最终结果的准确性。本文将带你完整走一遍这个流程。无论你是想用STM32做一个环境监测节点还是为更复杂的系统如恒温控制、电池管理系统添加温度监控功能这里的内容都将提供可直接复现的步骤和必须注意的“坑”。我们会基于STM32CubeMX进行配置但重点会放在配置背后的原理和代码实现的细节上确保你不仅“配得出”更能“懂得为什么这么配”。2. 核心硬件与原理深度解析2.1 温度传感方案选型与原理获取温度值首先需要一个将温度这个物理量转换为电信号的传感器。在电子领域主要有以下几种常见方案选择哪一种直接决定了后续ADC配置和数据处理逻辑。1. 热敏电阻NTC/PTC这是成本最低的方案之一。NTC负温度系数热敏电阻的阻值随温度升高而降低。通常我们会将其与一个固定阻值的标准电阻串联构成分压电路。ADC测量的是热敏电阻上的分压值通过公式计算其电阻再根据热敏电阻的B值参数表或Steinhart-Hart方程反推出温度。注意热敏电阻的非线性非常严重。虽然可以通过公式计算但在要求不高的场合更实用的做法是“查表法”。即预先测量出一系列温度点对应的ADC值在程序中通过查表加线性插值来获取温度这比实时解复杂方程要高效、准确得多。2. 集成模拟温度传感器如LM35这类芯片将感温元件和信号调理电路集成在一起直接输出与温度成线性关系的电压信号。例如LM35其输出电压为10mV/°C在0°C时输出0V。这种方案极大简化了设计ADC读取电压后只需简单的乘法运算即可得到温度值线性度好精度也更高。实操心得使用LM35时务必注意其供电电压通常4V-30V和输出范围。如果你的系统是3.3V供电LM35在测量高于100°C的温度时输出电压可能超过3.3V导致ADC读数饱和。此时需要考虑电阻分压或选择低压版本的传感器。3. 数字温度传感器如DS18B20这类传感器通过单总线、I2C或SPI等数字接口直接输出数字温度值完全绕过了ADC。虽然精度高、抗干扰能力强但其协议实现相对复杂且不符合本项目“使用AD转换”的核心练习目标。因此本文将以最经典、也最具教学意义的NTC热敏电阻分压电路和LM35直接测量两种方案作为主线进行阐述。2.2 STM32的ADC外设关键概念在配置CubeMX之前必须理解STM32 ADC的几个核心概念这决定了配置的准确性。1. 分辨率STM32的ADC通常支持6位到16位的分辨率具体取决于型号最常见的是12位。12位分辨率意味着ADC可以将参考电压范围划分为2^12 4096个等级。对于3.3V的参考电压每个数字量LSB代表的电压值是 3.3V / 4096 ≈ 0.806mV。分辨率越高对电压变化的感知越细腻但转换时间也可能越长。2. 采样时间这是ADC模块对输入信号进行采样并保持的时间。输入信号源通常有内阻ADC内部有一个采样电容。采样时间必须足够长让采样电容上的电压充分接近外部信号电压。如果时间太短转换结果就会不准确。CubeMX中通常以“时钟周期”为单位进行设置。信号源内阻越大所需的采样时间就越长。对于直接连接LM35输出阻抗低或通过运放缓冲的电路采样时间可以设短些对于通过大阻值电阻分压的NTC电路就必须设置较长的采样时间。3. 参考电压ADC转换的基准。对于STM32通常有VREF和VREF-引脚部分型号内部连接到VDDA和VSSA。转换结果 (输入电压 -VREF-) / (VREF-VREF-) * 满量程值。VREF的稳定性直接决定了ADC的精度。如果系统对精度要求高应使用独立、稳定的基准电压源而不是直接采用供电电源。4. 转换模式单次转换触发一次转换一个通道后停止。连续转换ADC启动后不停地循环转换指定的通道序列。扫描模式配合多通道使用ADC按顺序自动转换一组预先配置好的通道。 对于温度这种变化不快的信号通常采用单次转换模式然后由定时器周期性触发这样可以降低功耗。也可以使用连续转换模式但需要配合DMA或中断及时读取数据避免数据丢失。3. 基于CubeMX的工程配置详解我们以STM32F103C8T6蓝色药丸板为例使用STM32CubeMX v6.11进行配置。目标是配置一个ADC通道用于测量温度传感器电压。3.1 系统基础与外设时钟配置新建工程与芯片选择打开CubeMX点击“New Project”在Part Number搜索栏输入“STM32F103C8”选择对应的型号。在图形化界面中可以看到芯片的引脚图。系统核心配置SYS在“System Core” - “SYS”中将“Debug”改为“Serial Wire”。这对于使用ST-LINK进行调试和下载是必须的否则芯片可能被锁死。时钟配置RCC在“System Core” - “RCC”中将“High Speed Clock (HSE)”设置为“Crystal/Ceramic Resonator”。大部分开发板都外接了8MHz的晶振。点击顶部的“Clock Configuration”标签页进入时钟树界面。这是一个关键步骤。我们的目标是让系统主频达到72MHzF103系列的常见最高频率。具体设置将HSE输入频率设为8MHz。在PLL Source Mux选择HSE。然后配置PLL倍频因子为9这样PLL输出时钟为8MHz * 9 72MHz。接着将系统时钟源选择为PLL。此时HCLKAHB总线时钟会自动变为72MHz。APB2总线时钟PCLK2ADC挂载于此通常设置为与HCLK同频或分频这里我们保持72MHz。APB1总线时钟PCLK1最高36MHz系统会自动将其设置为36MHz。重要提示ADC的时钟ADCCLK来源于PCLK2但最大频率不能超过14MHz对于F1系列。在时钟树中需要为ADC Prescaler选择分频系数。PCLK2是72MHz我们选择6分频得到ADCCLK 72MHz / 6 12MHz符合要求。这是新手极易忽略导致ADC工作异常的关键点3.2 ADC通道与参数详细配置启用ADC在左侧“Analog”分类下找到“ADC1”。点击IN0、IN1等通道对应的引脚例如PA0将其设置为“ADC1_IN0”。引脚颜色会变为绿色。ADC参数设置点击“ADC1”在右侧出现详细配置页。Mode选择“Independent mode”独立模式。Scan Conversion Mode对于单通道选择“Disabled”。如果后续要启用多通道扫描则需开启。Continuous Conversion Mode选择“Disabled”。我们采用单次转换由软件或定时器触发。Discontinuous Conversion Mode禁用。End Of Conversion Selection选择“EOC flag at the end of single conversion”单次转换后置位EOC标志。Data Alignment选择“Right alignment”右对齐。这样12位转换结果存储在16位数据寄存器的低12位便于直接读取。DMA Continuous Requests如果不用DMA保持禁用。通道配置切换到“Parameter Settings”下的“ADC_Regular_ConversionMode”。点击“Add”按钮添加一个规则组通道。在“Rank”中选择“1”。在“Channel”中选择你连接的引脚对应的通道例如“Channel 0”。Sampling Time采样时间这是重中之重点击下拉菜单你会看到一系列以时钟周期为单位的选项如“1.5 cycles”、“7.5 cycles”、“239.5 cycles”。如何选择这里需要一个简单的计算。ADC的采样时间必须满足T_sampling (R_source R_ADC) * C_ADC * ln(2^n)。 其中R_ADC是ADC内部采样开关电阻约1kΩ~几十kΩ查数据手册C_ADC是内部采样电容约几pF查数据手册n是ADC分辨率位数。 对于LM35输出阻抗1Ω即使选择最短的1.5个周期也绰绰有余。但对于NTC分压电路假设上拉电阻为10kΩNTC在常温下也为10kΩ则信号源内阻约为两者并联值5kΩ。假设R_ADC为10kΩC_ADC为8pFn为12。计算可得最小采样时间约为(5k10k)*8pF*ln(4096) ≈ 0.00000066秒 0.66us。我们的ADCCLK是12MHz一个周期是83.3ns。0.66us / 83.3ns ≈ 8个周期。因此选择“13.5 cycles”或“28.5 cycles”是安全且常见的做法。在不确定的情况下选择较长的采样时间如239.5 cycles是稳妥的代价是转换速度变慢。触发源配置在“ADC_Regular_ConversionMode”中找到“External Trigger Conversion Source”。默认是“Software trigger”软件触发即调用HAL_ADC_Start()启动转换。你也可以选择“Timer 2 Trigger Out event”等实现定时自动触发采样这对于周期性采集非常有用。3.3 生成工程与代码框架项目设置点击顶部“Project Manager”标签页。设置“Project Name”和“Project Location”。在“Toolchain / IDE”中选择你使用的IDE如“MDK-ARM V5”Keil或“STM32CubeIDE”。在“Code Generator”中务必勾选“Generate peripheral initialization as a pair of ‘.c/.h’ files per peripheral”。这会将ADC的初始化代码独立成文件结构更清晰。生成代码点击右上角的“GENERATE CODE”。CubeMX会生成完整的工程文件。首次生成可能会提示安装固件库确认即可。4. 温度采集代码实现与数据处理生成了代码我们进入最关键的环节编写应用层代码读取ADC值并转换为温度。4.1 ADC数据读取基础函数打开IDE中的工程找到主循环main.c文件中的while(1)部分。首先我们实现最基本的ADC读取。// 在main.c的/* USER CODE BEGIN PV */区定义变量 uint32_t adc_value 0; float voltage 0.0; float temperature_c 0.0; // 在while(1)循环中 HAL_ADC_Start(hadc1); // 启动ADC转换 if (HAL_ADC_PollForConversion(hadc1, 100) HAL_OK) // 等待转换完成超时100ms { adc_value HAL_ADC_GetValue(hadc1); // 获取12位转换结果 HAL_ADC_Stop(hadc1); // 停止ADC // 计算电压值假设VREF 3.3V 12位分辨率 voltage (float)adc_value * 3.3f / 4095.0f; // 后续将voltage转换为温度 }这段代码使用了轮询方式简单但效率低在等待转换时会阻塞CPU。4.2 方案一LM35温度计算LM35的输出电压与温度是线性关系V_out (mV) 10 * T (°C)。因此计算非常简单// 接续上面的voltage计算之后 // voltage单位是伏特(V) LM35输出是10mV/°C所以 temperature_c voltage * 1000.0f / 10.0f; // 或者更直接 temperature_c voltage * 100.0f; printf(ADC Value: %lu, Voltage: %.3f V, Temperature: %.2f C\r\n, adc_value, voltage, temperature_c); HAL_Delay(1000); // 每秒采样一次注意事项这里隐含了一个假设ADC的参考电压VREF精确等于3.300V。实际上电源电压可能有波动。如果对精度要求高可以测量实际的VREF电压例如使用万用表或者使用STM32内部自带的一个内部参考电压VREFINT通道来校准。原理是先读取VREFINT通道的ADC值其对应的电压值是芯片出厂时校准过的例如1.2V通过这个比例关系可以反推出当前的VREF实际电压。这是提高精度的进阶技巧。4.3 方案二NTC热敏电阻温度计算查表插值法对于NTC我们采用更实用的查表法。首先你需要获取或测量NTC的电阻-温度对应表。假设我们使用一个10kΩ (25°C) 的NTC与一个10kΩ的固定电阻串联接3.3V。ADC测量NTC两端的电压。创建电阻-温度表在程序中定义一个数组存储一系列温度点对应的ADC值或电阻值。这个表可以通过实验测量或根据NTC的B值参数计算得出。我们以计算为例// 在文件开头定义查表数据 typedef struct { int16_t temp; // 温度单位0.1°C例如250代表25.0°C uint16_t adc; // 该温度下预期的ADC值 } TempADC_Map; // 假设我们根据B值公式计算了-10°C到60°C的数据步进5°C const TempADC_Map ntc_table[] { {-100, 3800}, // -10.0°C { -50, 3500}, // -5.0°C { 0, 3150}, // 0.0°C { 50, 2750}, // 5.0°C { 100, 2350}, // 10.0°C { 150, 1950}, // 15.0°C { 200, 1580}, // 20.0°C { 250, 1250}, // 25.0°C (此时NTC电阻为10k分压1.65VADC值约2048) { 300, 980}, // 30.0°C { 350, 760}, // 35.0°C { 400, 590}, // 40.0°C { 450, 460}, // 45.0°C { 500, 360}, // 50.0°C { 550, 280}, // 55.0°C { 600, 220}, // 60.0°C }; const uint16_t ntc_table_size sizeof(ntc_table) / sizeof(ntc_table[0]);查表与线性插值函数编写一个函数根据当前ADC值在表中找到相邻的两个点进行线性插值计算温度。float get_temperature_from_adc(uint16_t adc_val) { // 边界检查 if (adc_val ntc_table[0].adc) { return (float)ntc_table[0].temp / 10.0f; // 低于最低温返回表头温度 } if (adc_val ntc_table[ntc_table_size - 1].adc) { return (float)ntc_table[ntc_table_size - 1].temp / 10.0f; // 高于最高温 } // 查找adc_val所在的区间 uint16_t i; for (i 0; i ntc_table_size - 1; i) { if (adc_val ntc_table[i].adc adc_val ntc_table[i1].adc) { break; } } // 线性插值: y y0 (x - x0) * (y1 - y0) / (x1 - x0) float temp0 (float)ntc_table[i].temp / 10.0f; float temp1 (float)ntc_table[i1].temp / 10.0f; float adc0 (float)ntc_table[i].adc; float adc1 (float)ntc_table[i1].adc; float temperature temp0 (adc_val - adc0) * (temp1 - temp0) / (adc1 - adc0); return temperature; } // 在主循环中使用 adc_value HAL_ADC_GetValue(hadc1); temperature_c get_temperature_from_adc(adc_value); printf(ADC: %lu, Temp: %.2f C\r\n, adc_value, temperature_c);实操心得查表法的精度和范围取决于表的密度和测量/计算的准确性。在温度变化平缓的区域表可以稀疏一些在变化剧烈的区域如低温段需要更密的点。使用线性插值在点足够密的情况下精度完全可以满足大多数应用需求且计算量远小于实时解算B值方程。4.4 使用DMA实现后台连续采样与滤波轮询方式效率低且无法进行连续多次采样以滤波。更优的方案是使用DMA定时器触发。CubeMX中启用DMA在“Analog”-“ADC1”-“DMA Settings”中点击“Add”选择“ADC1”。模式选择“Circular”循环模式这样DMA会持续不断地将ADC转换数据搬运到指定内存地址。配置定时器触发在“ADC1”的“Parameter Settings”中将“External Trigger Conversion Source”改为某个定时器的触发输出例如“Timer 2 Trigger Out event”。然后去配置一个定时器如TIM2使其以固定频率如100Hz产生一个触发事件TRGO。生成代码并修改生成代码后在main.c中定义一个大的数组作为DMA搬运的目标缓冲区。// USER CODE BEGIN PV #define ADC_BUFF_SIZE 256 uint32_t adc_dma_buffer[ADC_BUFF_SIZE]; // USER CODE END PV // 在main函数初始化部分启动ADC的DMA转换 HAL_ADC_Start_DMA(hadc1, (uint32_t*)adc_dma_buffer, ADC_BUFF_SIZE); // 同时启动触发ADC的定时器 HAL_TIM_Base_Start(htim2); HAL_TIM_Trig_Config(htim2, TIM_TRGO_UPDATE); // 配置更新事件为TRGO此时ADC会在定时器的驱动下以固定频率自动进行转换DMA自动将结果存入adc_dma_buffer完全无需CPU干预。数据处理与滤波在主循环中你可以定期比如每秒一次去处理这个缓冲区里的数据。最简单的滤波是算术平均滤波。// 在while(1)中或另一个定时器中断中 uint32_t sum 0; for(int i0; iADC_BUFF_SIZE; i) { sum adc_dma_buffer[i]; } uint32_t adc_average sum / ADC_BUFF_SIZE; // 使用adc_average进行温度计算注意事项使用DMA循环模式时缓冲区是“环形”的新数据会覆盖旧数据。如果你需要处理所有数据可以使用“Normal”模式并在DMA传输完成中断中重新启动。另外ADC_BUFF_SIZE不宜过大以免DMA搬运耗时过长影响其他操作也不宜过小以免滤波效果差。通常32、64、128、256都是常见选择。5. 精度提升、校准与常见问题排查5.1 如何提升测量精度硬件层面参考电压使用独立的低压差基准电压源如REF3033为VREF引脚供电而不是使用MCU的VDDA。电源去耦在VDDA和VSSA引脚附近放置足够且靠近的0.1uF和10uF电容滤除电源噪声。信号调理对于高内阻信号源如NTC分压在ADC输入引脚前加入一个电压跟随器运放构成提供低输出阻抗。PCB布局模拟信号走线尽量短远离数字信号线特别是时钟线用地线包围。软件层面过采样与抽取以高于需求的速度采样然后将多个样本累加平均。例如想要14位有效分辨率可以对4个12位样本求和平均过采样4倍。这能抑制白噪声提升有效位数。数字滤波除了平均滤波还可以使用滑动平均、中值滤波或一阶低通滤波软件实现来抑制周期性干扰和脉冲噪声。内部参考电压校准如前所述使用VREFINT通道校准实际参考电压。STM32 HAL库提供了HAL_ADCEx_Calibration_Start()函数可以启动内部校准修正ADC的偏移和线性度误差。每次上电后或环境温度剧烈变化后执行一次校准能显著提升精度。5.2 典型问题与解决方案速查表问题现象可能原因排查步骤与解决方案ADC读数始终为0或接近01. ADC未正确启动或触发。2. 采样时间太短信号未建立。3. 引脚配置错误复用功能未开启。4. 传感器损坏或接线错误。1. 检查HAL_ADC_Start或HAL_ADC_Start_DMA是否被调用返回状态是否为HAL_OK。2. 大幅增加采样时间如设为239.5 cycles测试。3. 在CubeMX中确认引脚已配置为ADC模式并重新生成代码。4. 用万用表测量ADC输入引脚对地电压确认传感器有正常输出。ADC读数始终为4095满量程1. 输入电压超过参考电压VREF。2. ADC输入引脚悬空或感应到噪声。3. 内部参考电压选择错误如误选了VREFINT。1. 测量输入电压是否确实超过3.3V或你设定的VREF。2. 确保引脚连接到有效的信号源或尝试在引脚上加一个下拉电阻如100kΩ到地。3. 检查CubeMX中ADC通道选择是否正确。ADC读数跳动噪声大1. 电源噪声大。2. 信号源内阻高采样时间不足。3. PCB布局干扰。4. 未进行滤波处理。1. 检查电源纹波加强电源滤波。2. 增加ADC采样时间。3. 检查模拟走线远离数字区域。4. 在软件中实现多次采样取平均或更复杂的滤波算法。温度计算值偏差大1. 参考电压不准电源电压波动。2. 传感器参数不准如NTC的B值、分压电阻精度。3. 计算公式或查表数据有误。4. ADC未校准。1. 使用万用表测量实际的VREF电压代入公式计算。或启用内部VREFINT校准。2. 使用高精度电阻或对传感器和电阻进行实际标定。3. 使用已知温度冰水混合物0°C沸水100°C需注意气压影响进行两点校准修正公式中的参数。4. 调用HAL_ADCEx_Calibration_Start()进行校准。DMA模式数据不更新1. DMA或ADC未正确启动。2. DMA缓冲区指针或大小错误。3. 触发源定时器未工作。1. 确认启动顺序先HAL_ADC_Start_DMA再启动触发定时器。2. 检查HAL_ADC_Start_DMA函数传入的缓冲区地址和长度是否正确。3. 使用调试器查看定时器的计数寄存器是否在递增或检查定时器配置。5.3 进阶优化低功耗与实时性考量如果你的设备是电池供电需要关注功耗。频繁的ADC转换和CPU处理会消耗可观的能量。间歇采样不要以最高频率连续采样。对于温度这种慢变信号可以设置为每10秒甚至每分钟采样一次。在采样间隙将MCU和ADC置于低功耗模式Stop模式。使用RTC或低功耗定时器LPTIM来唤醒系统进行下一次采样。使用内部温度传感器STM32芯片内部通常集成了一个温度传感器它连接到一个专用的ADC通道。虽然它的绝对精度不高±2°C左右但用于监测芯片自身结温、进行温度补偿或粗略环境温度感知是足够的且无需外接元件。在CubeMX中启用“Temperature Sensor Channel”即可。读取后需根据数据手册中的公式进行换算。从配置一个ADC通道到稳定、准确地读取温度值这个过程涵盖了嵌入式数据采集的典型工作流。我个人的体会是硬件是基础软件是灵魂而理解原理是连接两者的桥梁。CubeMX帮你解决了繁琐的底层配置让你能更专注于应用逻辑。但当你遇到读数不稳、精度不够时回头审视硬件电路、ADC配置参数和软件处理算法往往能找到问题的根源。最后一个小技巧在调试ADC时善用调试器实时观察变量值同时用串口打印出原始ADC值、计算出的电压和温度对比万用表实测值是快速定位问题的有效方法。掌握了这些你就能让STM32的ADC真正可靠地为你工作成为项目感知环境的“眼睛”。