Zephyr RTOS驱动开发实战：ADC驱动

从一次诡异的电压跳变说起

去年做工业传感器采集项目，凌晨三点盯着逻辑分析仪发呆。ADC采集到的温度信号每隔17秒会跳变0.3V，像幽灵一样准时。查了三天，从电源纹波排查到PCB走线，最后发现是Zephyr的ADC采样缓冲区没对齐——DMA传输时低4位数据被截断。这个坑让我意识到，ADC驱动看似简单，但Zephyr的硬件抽象层藏着不少暗礁。

硬件层：别被“通用”二字骗了

Zephyr的ADC驱动API设计得相当优雅，但底层实现完全依赖SoC的ADC外设特性。以STM32为例，它的ADC支持单次、连续、扫描、注入四种模式，而nRF52的SAADC只有单次和连续。写驱动前必须啃透芯片参考手册的ADC章节，特别是采样时间、分辨率、参考电压这三个参数。

采样时间这个参数最容易翻车。某次用STM32G4采集音频信号，设置采样周期为2.5个ADC时钟周期，结果高频分量全部衰减。后来发现手册里写着“当采样时间小于1μs时，内部采样电容无法完全充电”。Zephyr的adc_channel_cfg结构体里有个sampling_time字段，但不同SoC的数值含义完全不同——STM32用ADC时钟周期数，nRF52用微秒，而某些国产MCU直接是寄存器索引值。

分辨率设置更是个坑。Zephyr的adc_sequence_options里resolution