1. 为什么ADC校准值得单独拎出来讲STM32H743 这颗片子我在好几个高速采集项目里用过16 位分辨率、3.6 MSPS 的 ADC 算是它的招牌之一。但很多人拿到 CubeMX 生成的工程看到HAL_ADCEx_Calibration_Start()这行代码基本就是哦初始化里自动生成的留着吧然后该跑跑该调调从来没想过它到底干了什么。直到某天发现采样值总有个几十 LSB 的固定偏置或者温度一变化数据就飘才开始回头翻这行代码。ADC 校准这件事本质上是在补偿芯片制造过程中不可避免的模拟电路失配。CMOS 工艺做出来的电容阵列、比较器、参考缓冲每一颗芯片之间都有差异甚至同一颗芯片在不同温度和电压下表现也不一样。STM32H743 的 ADC 内部有一套自校准逻辑能把这些失配量测出来并写进内部的校准寄存器后续每次转换都会自动扣掉这个偏差。而HAL_ADCEx_Calibration_Start()就是触发这套逻辑的入口。这篇文章我打算从 HAL 库源码的角度把这行函数从调用到寄存器操作整条链路拆开讲清楚。适合两类人看一类是已经会用 HAL 库但想搞明白底层在干什么的嵌入式工程师另一类是遇到 ADC 精度问题、想从校准机制入手排查的调试者。看完你至少能回答三个问题校准到底校的是什么、H743 的校准和 F1/F4 有什么本质区别、以及为什么有些场景下你必须手动重新校准。2. HAL_ADCEx_Calibration_Start 的调用链路拆解2.1 从应用层到寄存器三层调用结构先看这个函数在 HAL 库里的位置。它定义在stm32h7xx_hal_adc_ex.c里属于扩展功能文件而不是基础的stm32h7xx_hal_adc.c。这个文件划分本身就说明了一件事校准不是 ADC 的基础操作而是扩展能力。对比一下 F1 系列校准函数HAL_ADCEx_Calibration_Start()同样在 ex 文件里但 F1 的校准是必须的不校准 ADC 根本不工作而 H743 的校准是可选的不调用也能转换只是精度没保证。函数原型是这样的HAL_StatusTypeDef HAL_ADCEx_Calibration_Start(ADC_HandleTypeDef *hadc, uint32_t CalibrationMode, uint32_t SingleDiff);三个参数里hadc是 ADC 句柄CalibrationMode在 H743 上只有ADC_CALIB_OFFSET和ADC_CALIB_OFFSET_LINEARITY两个选项SingleDiff用来区分单端和差分输入模式。这个参数设计比 F4 复杂F4 只有一个SingleDiff参数因为 F4 的校准只有一种模式。调用链往下走函数内部大致分四步参数合法性检查、退出掉电模式、配置校准模式、启动校准并等待完成。每一步都有对应的寄存器操作我们逐个看。2.2 参数检查与前置条件函数开头有一段assert_param检查确认hadc不为空、CalibrationMode和SingleDiff是合法值。这些在 Release 编译下会被优化掉但 Debug 版本能帮你挡住传错参数的坑。我见过有人把SingleDiff传成ADC_SINGLE_ENDED之外的值结果校准跑完数据反而更差就是这里没检查出来。紧接着有个关键判断ADC 必须处于关闭状态。源码里会检查ADC_CR_ADEN位如果 ADC 已经使能函数直接返回HAL_ERROR。这一点很多人踩坑——在HAL_ADC_Start()之后才想起来要校准结果函数静默失败返回错误码也没人看。正确的顺序永远是HAL_ADC_Init()→HAL_ADCEx_Calibration_Start()→HAL_ADC_Start()。注意H743 的校准必须在 ADC 禁用状态下进行这和 F1 不同。F1 的校准也是在 ADON0 时做但 F1 的 ADON 控制逻辑和 H7 的 ADEN 不完全一样移植代码时别想当然。2.3 退出掉电模式与稳压器使能H743 的 ADC 有个深度掉电模式Deep Power Down上电默认可能处于这个状态。校准前必须先唤醒。源码里会操作ADC_CR寄存器的DEEPPWD位清零然后置位ADVREGEN使能内部稳压器。这里有个时序要求稳压器使能后需要等待一段时间才能稳定源码里用HAL_GetTick()做超时等待典型值是 10 微秒左右。如果你在低功耗场景下频繁开关 ADC这个等待时间会累积成可观的功耗开销。我的做法是如果采集是周期性的干脆不让 ADC 进深度掉电保持稳压器常开用ADC_CR_ADVREGEN一直置位牺牲一点静态功耗换响应速度。2.4 校准模式的寄存器配置这是 H743 校准和 F4 最大的区别所在。F4 的校准只有一种模式配置简单H743 提供了两种ADC_CALIB_OFFSET只校准偏移误差速度快适合对精度要求不极端的场景ADC_CALIB_OFFSET_LINEARITY偏移加线性度校准耗时长但能修正整个转换曲线的非线性源码里根据CalibrationMode参数设置ADC_CR寄存器的ADCALLIN位。置 1 就是线性度校准清 0 就是仅偏移校准。这个选择直接影响校准耗时——线性度校准在 H743 上典型要几百个 ADC 时钟周期如果 ADC 时钟是 50 MHz大概几微秒到十几微秒。SingleDiff参数则影响ADC_CR的ADCALDIF位。单端模式下校准的是单端输入通道的误差差分模式下校准差分通道。这里有个容易忽略的点如果你同时用单端和差分通道需要分别校准两次因为两种模式的误差特性不一样。3. 校准背后的模拟原理与 H743 的特殊设计3.1 校准到底在补偿什么要理解校准得先知道 ADC 的误差从哪来。STM32H743 的 ADC 是逐次逼近型SAR核心是一个电容 DAC 阵列加比较器。理想情况下每个电容的容值应该是二进制加权的比如 1C、2C、4C、8C……但实际制造出来每个电容都有偏差可能是标称值的 0.1% 到 1%。这些偏差累积起来就导致转换结果偏离理想值。校准的过程本质上是让 ADC 自己去测量这些偏差。具体做法是内部把输入短接到一个已知的参考点通常是地或者某个内部基准然后跑一次转换看结果偏离零多少这个偏离量就是偏移误差。线性度校准更复杂一些会在多个码值点上测量偏差拟合出一条修正曲线。H743 的校准结果会写进内部的校准寄存器这些寄存器对用户不可见但每次转换时硬件会自动读取并应用修正。所以你不需要在软件里做任何补偿校准一次后续转换自动受益。3.2 H743 与 F1/F4 校准机制的本质差异用过 F1 的人都知道F1 的 ADC 不校准根本没法用上电第一件事就是调HAL_ADCEx_Calibration_Start()而且 F1 的校准必须在 ADC 使能之前做做完才能开 ADC。F4 类似校准也是推荐必做。H743 不一样。它的校准是可选的而且校准的粒度更细。F1/F4 的校准基本就是一次偏移校准H743 把偏移和线性度拆开了。这个设计变化背后是 H743 的 ADC 精度指标更高——16 位分辨率下线性度误差的影响比 12 位时大得多所以 ST 给了你一个要不要花时间做线性度校准的选择权。另一个差异是校准的触发方式。F1/F4 的校准是启动后自动完成你只需要等CAL位清零。H743 也是类似机制但多了个ADCAL位的状态查询而且校准完成后ADCAL位由硬件清零你需要轮询这个位来判断校准是否结束。源码里就是用while循环等这个位。3.3 校准与温度、电压的关系这里要泼一盆冷水校准不是一劳永逸的。校准补偿的是芯片在特定温度、特定电压下的误差。当温度变化超过一定范围或者供电电压波动之前校准的结果可能就不准了。STM32H743 的参考手册里明确写了校准应该在与后续转换相同的条件下进行。什么意思如果你校准的时候芯片是 25 度然后跑到 85 度的环境里采集校准效果会打折扣。我的经验是如果应用场景温度变化超过 40 度最好在温度稳定后重新校准一次或者干脆用外部基准加软件补偿。电压方面H743 的 ADC 参考电压可以是内部基准VREFBUF或者外部 VREF。如果用内部基准校准和转换时的基准一致性有保证如果用外部基准要确保校准和转换时外部基准没有波动否则校准白做。4. 完整实操从零配置一次可靠的 ADC 校准4.1 CubeMX 配置要点用 CubeMX 配置 H743 的 ADC 时有几个选项直接关系到校准能不能正常工作。首先是ADCx的Clock Prescaler。H743 的 ADC 时钟来自adc_ker_ck经过分频后给 ADC 用。校准需要 ADC 时钟在合理范围内太快太慢都不行。参考手册推荐校准时的 ADC 时钟不超过 50 MHz。CubeMX 里选Synchronous clock mode divided by 4之类的分频具体看你的系统时钟。然后是Resolution。H743 支持 16 位、14 位、12 位、10 位、8 位。校准的精度和分辨率有关16 位下校准能修正的细节最多。如果你用 16 位建议选ADC_CALIB_OFFSET_LINEARITY如果只用 12 位ADC_CALIB_OFFSET就够了。Scan Conversion Mode和Continuous Conversion Mode在校准阶段不影响但校准完成后这些设置决定转换行为。注意Discontinuous Conversion Mode如果开了校准后的第一次转换可能行为异常建议校准期间保持默认。4.2 手写校准代码的完整流程CubeMX 生成的代码里校准调用通常藏在MX_ADC1_Init()里但很多人没注意它到底在哪一步。我习惯把校准单独拎出来放在main()里显式调用这样逻辑更清楚/* ADC1 初始化 */ hadc1.Instance ADC1; hadc1.Init.ClockPrescaler ADC_CLOCK_ASYNC_DIV4; hadc1.Init.Resolution ADC_RESOLUTION_16B; hadc1.Init.ScanConvMode ADC_SCAN_DISABLE; hadc1.Init.EOCSelection ADC_EOC_SINGLE_CONV; hadc1.Init.LowPowerAutoWait DISABLE; hadc1.Init.ContinuousConvMode DISABLE; hadc1.Init.NbrOfConversion 1; hadc1.Init.DiscontinuousConvMode DISABLE; hadc1.Init.ExternalTrigConv ADC_SOFTWARE_START; hadc1.Init.ExternalTrigConvEdge ADC_EXTERNALTRIGCONVEDGE_NONE; hadc1.Init.ConversionDataManagement ADC_CONVERSIONDATA_DR; hadc1.Init.Overrun ADC_OVR_DATA_PRESERVED; hadc1.Init.LeftBitShift ADC_LEFTBITSHIFT_NONE; hadc1.Init.OversamplingMode DISABLE; if (HAL_ADC_Init(hadc1) ! HAL_OK) { Error_Handler(); } /* 校准必须在 HAL_ADC_Start 之前 */ if (HAL_ADCEx_Calibration_Start(hadc1, ADC_CALIB_OFFSET_LINEARITY, ADC_SINGLE_ENDED) ! HAL_OK) { Error_Handler(); } /* 校准完成后再启动 ADC */ if (HAL_ADC_Start(hadc1) ! HAL_OK) { Error_Handler(); }这段代码里HAL_ADC_Init()内部其实已经做了一部分准备工作包括退出掉电模式、使能稳压器。所以HAL_ADCEx_Calibration_Start()进来的时候ADC 已经处于可校准状态。但如果你在HAL_ADC_Init()之后手动改过ADC_CR寄存器比如关了稳压器校准就会失败。4.3 校准耗时的实测数据我在 H743 上实测过不同配置下的校准耗时用 DWT 周期计数器测的系统时钟 480 MHzADC 时钟 50 MHz校准模式分辨率实测耗时微秒备注OFFSET16 位约 8最快适合快速启动OFFSET_LINEARITY16 位约 22精度最好OFFSET12 位约 612 位下线性度影响小OFFSET_LINEARITY12 位约 18性价比一般这个耗时看起来不长但在低功耗应用里每次唤醒都做线性度校准会明显增加平均功耗。我的策略是上电时做一次OFFSET_LINEARITY后续从低功耗唤醒时只做OFFSET甚至不做靠上电时的校准结果撑着。4.4 校准结果的验证方法校准做完了怎么知道有没有效果最直接的办法是采集一个已知电压看读数偏差。比如用内部参考电压通道VREFINTH743 的 VREFINT 典型值是 1.21V读出来换算成电压和典型值对比。更严谨的做法是采集多个码值点画输入输出曲线看线性度。我一般用可调电源从 0.1V 扫到 3.2V步进 0.1V记录 ADC 读数然后算 INL积分非线性和 DNL微分非线性。校准前 INL 可能有 ±10 LSB校准后能压到 ±3 LSB 以内。提示验证校准效果时确保输入电压稳定用万用表实测输入电压作为参考不要相信电源的显示值。电源显示和实际输出经常差几十毫伏。5. 常见问题与排查技巧实录5.1 校准返回 HAL_ERROR 的几种原因HAL_ADCEx_Calibration_Start()返回错误最常见的原因有这么几个第一ADC 已经使能。前面说过校准必须在ADEN0时做。如果你在HAL_ADC_Start()之后调校准必然失败。检查代码顺序。第二稳压器没使能或没稳定。HAL_ADC_Init()里会等稳压器稳定但如果你在HAL_ADC_Init()之后手动关了ADVREGEN或者等待时间不够校准会超时。H743 的稳压器稳定时间典型 10 微秒源码里的超时值一般够用但如果系统时钟配置异常导致HAL_GetTick()不准可能误判超时。第三ADC 时钟没开。H743 的 ADC 时钟来自adc_ker_ck需要在 RCC 里使能。CubeMX 一般会自动配好但如果你手动改过 RCC 配置检查RCC_PERIPHCLK_ADC是否使能。第四校准模式参数非法。CalibrationMode只能传ADC_CALIB_OFFSET或ADC_CALIB_OFFSET_LINEARITY传别的值assert_param会拦但 Release 版本下可能直接跑飞。5.2 校准后数据反而更差的排查这种情况我遇到过两次一次是差分模式没配对一次是校准和转换的参考电压不一致。差分模式下SingleDiff必须传ADC_DIFFERENTIAL_ENDED如果传了ADC_SINGLE_ENDED校准的是单端误差但转换是差分误差模型对不上结果反而更差。检查hadc.Init里的差分配置和校准参数是否一致。参考电压不一致的情况更隐蔽。如果你用外部 VREF校准的时候外部基准是 3.3V转换的时候掉到 3.2V校准补偿的量就不对了。解决办法是用内部 VREFBUF或者确保外部基准稳定。还有一种可能是校准没真正完成。源码里等ADCAL位清零但如果 ADC 时钟停了这个位永远不清零函数会超时返回。检查 ADC 时钟是否在跑。5.3 低功耗场景下的校准策略低功耗应用里每次唤醒都做完整校准太浪费。我的做法是分两级上电冷启动时做一次ADC_CALIB_OFFSET_LINEARITY把校准结果留在芯片里。然后进低功耗唤醒后如果温度变化不大比如用内部温度传感器读一下变化小于 10 度直接跳过校准用之前的校准结果。如果温度变化大做一次ADC_CALIB_OFFSET快速修正偏移。这个策略的前提是 H743 的校准结果在掉电后不丢失。实际上校准寄存器是易失的掉电就没了。所以上电冷启动指的是芯片不断电、只是 ADC 进低功耗的情况。如果整个芯片断电重启校准必须重做。场景校准策略理由上电冷启动OFFSET_LINEARITY精度优先只做一次温度变化 10 度跳过校准结果仍有效温度变化 10 度OFFSET快速修正偏移芯片断电重启OFFSET_LINEARITY校准寄存器已丢失5.4 多 ADC 实例的校准注意事项H743 有多个 ADCADC1、ADC2、ADC3每个都需要单独校准。校准是 per-instance 的ADC1 的校准结果不会自动应用到 ADC2。如果你用多重 ADC 模式比如交错采样提高采样率每个 ADC 都要在使能前校准。而且多重模式下各 ADC 的校准最好在相同的温度和电压条件下做否则通道间的偏差会引入新的误差。我做过一个双 ADC 交错采样的项目ADC1 和 ADC2 分别校准后通道间偏差从校准前的 20 LSB 降到了 3 LSB 以内。如果不校准交错采样的数据会有明显的周期性波动因为两个 ADC 的偏移不一样。6. 从源码延伸几个容易被忽略的细节6.1 校准与 ADC 电压调节器的关系H743 的 ADC 内部有个电压调节器给模拟电路供电。这个调节器的输出噪声直接影响 ADC 精度。校准的时候调节器必须处于稳定状态否则校准测出来的误差里混了调节器的噪声补偿就不准。源码里在使能ADVREGEN后有个等待循环但等待时间是基于典型值的。如果你的供电电压偏低比如 1.8V 系统调节器稳定时间会变长源码里的等待可能不够。这种情况我建议在HAL_ADC_Init()之后手动加个几微秒的延时再调校准。6.2 校准期间的 DMA 和中断校准期间ADC 不产生转换数据所以 DMA 和中断都不会触发。但如果你在校准前就使能了 DMA 请求校准完成后第一次转换可能会触发一个意外的 DMA 传输。我的习惯是校准完成后再配置 DMA避免这种边界情况。中断方面H743 的 ADC 有校准完成中断吗查了一下参考手册没有专门的校准中断。校准完成只能靠轮询ADCAL位。所以HAL_ADCEx_Calibration_Start()是个阻塞函数校准期间 CPU 干不了别的。如果校准耗时 20 微秒对大多数应用无所谓但在硬实时系统里要算进任务响应时间。6.3 不同 HAL 库版本的差异ST 的 HAL 库更新挺频繁的不同版本的HAL_ADCEx_Calibration_Start()实现可能有细微差别。我对比过 H7 的 1.8.0 和 1.9.0 版本主要差异在超时处理上。1.9.0 增加了对ADCAL位更严格的检查超时时间也调整了。如果你从旧版本升级 HAL 库校准相关的代码最好重新测一遍。特别是超时值旧版本可能偏短在新版本上反而正常了或者反过来。6.4 校准对采样率的影响校准本身不直接影响采样率但校准占用的时间会影响系统的启动时间。如果你做的是高速采集启动后要尽快进入采集状态校准的 20 微秒可能可以接受。但如果系统要求上电后 10 微秒内出数据那就只能跳过线性度校准甚至跳过校准靠外部基准和软件补偿。我一般会在项目初期就把校准耗时算进启动时间预算里。如果预算紧张先做OFFSET校准把OFFSET_LINEARITY放到后台任务里等系统稳定了再补做。7. 我个人的实操体会折腾 H743 的 ADC 校准这几年最大的体会是校准不是万能药但不校准是万万不能的。我见过太多项目ADC 数据有固定偏置第一反应是改电路、换基准折腾一圈最后发现是没校准。也见过相反的情况校准做了一大堆但电路本身的噪声和干扰没解决校准完了数据照样跳。校准解决的是芯片内部的系统性误差解决不了外部电路的随机噪声。所以正确的顺序是先把硬件做好基准稳定、输入滤波、地平面完整再谈校准。硬件不行校准白搭。另一个体会是别迷信线性度校准。ADC_CALIB_OFFSET_LINEARITY听起来很高级但在很多应用里ADC_CALIB_OFFSET就够了。线性度误差在 16 位下才明显如果你只用 12 位线性度校准的收益很小反而多花时间。我现在的默认配置是16 位用线性度校准12 位及以下用偏移校准。最后分享一个小技巧如果你怀疑校准没生效可以在校准前后各采集一次同一个已知电压对比读数。校准前的读数减去校准后的读数就是校准补偿掉的偏移量。这个值一般在几十 LSB 量级如果为零说明校准没起作用回去检查调用顺序和参数。
