第4章 ADC模块抽象

第4章 ADC模块抽象：模拟量采集的HAL封装、采样序列管理、结果DMA传输、精度与性能权衡

ADC模块，说白了就是把电压值变成数字量。很多刚入行的工程师觉得这玩意儿简单——配置个寄存器，读个值，完事。但真正到了车规级项目里，你会发现事情远没那么简单。

我个人习惯把ADC抽象分成三层：硬件访问层、序列管理层、数据分发层。这样分层的好处是，换MCU时只需要改最底层，上层逻辑纹丝不动。

4.1 HAL封装：把寄存器藏起来

先看一个典型的ADC HAL接口。我当年在做一个BMS项目时，就因为底层封装得不够干净，导致换芯片时改了整整两周代码。从那以后，我对HAL接口的设计就特别较真。

/* adc_hal.h - 车规级ADC硬件抽象层 */
typedef struct {
    uint32_t adc_base;      /* ADC外设基地址 */
    uint8_t  resolution;    /* 分辨率：8/10/12/16位 */
    uint8_t  sample_cycles; /* 采样周期数 */
    uint8_t  ref_sel;       /* 参考电压选择 */
    uint8_t  align;         /* 对齐方式：左/右对齐 */
} Adc_HwConfigType;

/* 初始化单个ADC硬件单元 */
Std_ReturnType Adc_HwInit(const Adc_HwConfigType* config);

/* 启动一次转换（单次模式） */
Std_ReturnType Adc_HwStartConversion(uint32_t adc_base, uint8_t channel);

/* 读取转换结果 */
Std_ReturnType Adc_HwReadResult(uint32_t adc_base, uint16_t* value);

/* 校准ADC（车规级必做） */
Std_ReturnType Adc_HwCalibrate(uint32_t adc_base);

核心设计原则：所有硬件寄存器操作都封装在.c文件里，头文件只暴露功能接口。这样即使底层寄存器布局变了，上层代码一行都不用改。

嗯，这里要注意一点：车规级ADC通常需要自校准。我见过一个项目，因为跳过了校准步骤，导致采集的电压值偏差了3%以上，这在电池管理系统中是致命的。

4.2 采样序列管理：别让CPU空等

实际项目中很少只采一个通道。比如发动机控制，同时要采进气温度、冷却液温度、节气门位置、氧传感器……少说七八路。如果每个通道都等转换完成再启动下一个，CPU就全耗在等待上了。

所以我们需要采样序列的概念。说白了，就是让ADC自己按顺序把一组通道采完，采完了再通知你。

/* 采样序列配置 */
typedef struct {
    uint8_t  channel_id;    /* 通道号 */
    uint8_t  sample_time;   /* 采样时间（单位：ADC时钟周期） */
    uint8_t  gain;          /* 可编程增益（如果有） */
    uint8_t  avg_count;     /* 硬件平均次数（1/4/8/16） */
} Adc_SeqChannelType;

typedef struct {
    uint8_t              num_channels;    /* 序列长度 */
    Adc_SeqChannelType   channels[16];    /* 最多16个通道 */
    uint8_t              trigger_src;     /* 触发源：软件/定时器/外部引脚 */
    uint8_t              priority;        /* 序列优先级（多序列时使用） */
} Adc_SeqConfigType;

/* 注册一个采样序列 */
Std_ReturnType Adc_SeqRegister(const Adc_SeqConfigType* seq);

/* 启动序列转换 */
Std_ReturnType Adc_SeqStart(uint8_t seq_id);

/* 查询序列是否完成 */
Std_ReturnType Adc_SeqGetStatus(uint8_t seq_id, Adc_SeqStatusType* status);

我的经验：采样序列的长度不要超过16个通道。为什么？因为大多数MCU的ADC结果寄存器就那么几个，序列太长会导致结果被覆盖。我曾经踩过这个坑，序列配了20个通道，结果前4个通道的数据总是对的，后面的全乱套了。

触发源的选择也很关键。我个人习惯：周期性采集用定时器触发，事件驱动型采集用外部引脚触发。比如轮速传感器，必须用硬件触发，软件触发根本来不及响应。

4.3 结果DMA传输：解放CPU

ADC转换完成后，数据怎么搬到内存？最笨的办法是CPU去读，但这样CPU就被绑死了。车规级系统里，CPU要干的事情太多了——控制逻辑、诊断、通信……哪有空一直盯着ADC结果寄存器？

所以，DMA是ADC的黄金搭档。配置好DMA，让ADC结果自动搬到内存数组里，CPU该干嘛干嘛。

/* DMA与ADC的链接配置 */
typedef struct {
    uint8_t              seq_id;          /* 关联的采样序列ID */
    uint16_t*            buffer;          /* 目标缓冲区 */
    uint16_t             buffer_len;      /* 缓冲区长度（半字为单位） */
    uint8_t              transfer_mode;   /* 传输模式：单次/循环 */
    void (*callback)(void);              /* 传输完成回调 */
} Adc_DmaConfigType;

/* 配置ADC到DMA的传输通道 */
Std_ReturnType Adc_DmaSetup(const Adc_DmaConfigType* dma_cfg);

/* 启动DMA传输（与序列启动配合） */
Std_ReturnType Adc_DmaStart(uint8_t seq_id);

/* 暂停DMA传输 */
Std_ReturnType Adc_DmaStop(uint8_t seq_id);

警告：DMA传输完成回调函数里绝对不能做耗时操作。我曾经在一个项目里，回调函数里调用了printf打印数据，结果导致系统中断响应超时，触发了看门狗复位。回调函数里只应该做两件事：设置一个标志位，或者通过消息队列通知任务。

缓冲区长度怎么定？我建议至少是序列长度的两倍。为什么？因为要用双缓冲（ping-pong buffer）。一个缓冲区在给上层应用处理，另一个缓冲区在接收新的ADC数据。这样数据不会丢，处理也不会卡。

4.4 精度与性能权衡：没有免费的午餐

做ADC设计时，你永远在跟三个东西打架：精度、速度、功耗。这三者不可能同时做到最好，必须有所取舍。

参数	高精度模式	高性能模式	低功耗模式
分辨率	16位	10位	8位
采样周期	112个时钟周期	8个时钟周期	4个时钟周期
转换速率	~10 kSPS	~1 MSPS	~2 MSPS
硬件平均	16次	关闭	关闭
典型应用	电池电压监测	电流过流检测	按键检测

你想想看，电池电压监测需要精确到毫伏级，但变化很慢，所以用高精度模式慢慢采没问题。但过流检测要求响应快，精度差一点没关系，只要别误触发就行。

实战建议：在同一个ADC外设上，可以混合使用不同精度的序列。比如序列0用高精度采电池电压，序列1用高性能采电流。两个序列通过不同优先级或不同触发源来调度。我在一个VCU项目中就是这么做的，效果很好。

还有一个容易被忽略的点：参考电压的稳定性。精度再高的ADC，如果参考电压在抖动，结果也是白搭。车规级设计里，我通常会在参考电压引脚上加一个低ESR的钽电容，容量至少10μF。别小看这个电容，它能滤掉发动机点火时产生的尖峰干扰。

4.5 避坑指南：那些年我踩过的ADC坑

采样时间不足：我曾经配了一个很短的采样时间，结果采集到的电压总是偏低。后来发现是采样电容还没充满就被切断了。解决办法：根据输入阻抗计算最小采样时间，留出20%余量。
通道间串扰：高阻抗信号源相邻通道切换时，会残留电荷。我习惯在序列里插入一个虚拟通道（不读结果），专门用来放掉残留电荷。
DMA地址对齐：有些MCU的DMA要求目标缓冲区地址按半字或字对齐。如果没对齐，DMA会触发错误中断。我一般用#pragma align或者属性修饰符来强制对齐。
看门狗干扰：ADC校准过程可能耗时较长（几毫秒），如果看门狗没喂，系统就复位了。校准前先喂一次狗，校准完再喂一次。

嗯，最后说一句：ADC的HAL封装，本质上是在硬件复杂性和软件易用性之间找一个平衡点。封装得太薄，换芯片时改得想哭；封装得太厚，性能损失又太大。我个人倾向于「够用就好」——把最常用的功能封装好，特殊场景留出底层访问接口。这样既保证了可移植性，又不失灵活性。

下一章我们会聊PWM模块的抽象设计，到时候再细说如何用HAL封装搞定各种花里胡哨的PWM需求。

📚 课程目录