问题现象与背景

在STM32项目中使用ADC多通道扫描+DMA传输时，很多开发者会遇到这样的现象：配置了通道0、1、2、3的扫描顺序，但DMA缓冲区中读到的数据却与预期通道不对应。例如，期望adc_buf[0]对应通道0，实际却对应通道2或其它通道。这种顺序错乱会导致后续数据处理完全错误。

本文基于STM32 HAL库，以STM32F4系列为例，分析该问题的根本原因，并给出两种实用的重排方案。

原理分析：ADC扫描序列与DMA的映射关系

ADC扫描模式的工作机制

ADC在扫描模式下，按照ADC_SQRx寄存器中配置的规则组序列依次转换。序列长度由ADC_SQR1的L位决定，每个序列位置（SQ1~SQ16）存放一个通道号。
转换顺序严格遵循SQ1→SQ2→…→SQn，与通道编号大小无关。例如SQ1=通道3，SQ2=通道0，则先转换通道3，再转换通道0。
每次转换完成后，结果存入ADC_DR寄存器，并触发DMA请求（如果使能了DMA连续请求）。

DMA传输与数据排列

DMA将ADC_DR中的数据依次搬运到用户缓冲区。由于ADC按SQ1~SQn顺序产生数据，DMA缓冲区中的第i个元素自然对应第i个序列位置（即SQi）的通道。
关键点：DMA缓冲区索引与ADC序列位置一一对应，而不是与通道编号对应。如果配置时序列顺序与预期通道顺序不一致，就会产生“错乱”。

常见配置误区

在CubeMX中，ADC的“Rank”列表顺序决定了扫描顺序。很多开发者误以为按通道编号从小到大排列就是正确顺序，但实际应按照自己期望的采集顺序配置Rank。
手动编写代码时，未正确设置ADC_RegularChannelConfig()的Rank参数，或调用顺序与Rank不匹配。
使用了不匹配的DMA缓冲区长度或未考虑ADC校准时间导致的首次数据偏移。

排查步骤

检查CubeMX中的Rank配置：打开.ioc文件，查看ADC配置的“Rank”列表，确认每个Rank对应的通道号是否与预期顺序一致。
检查代码中的序列配置：若使用LL或寄存器操作，检查ADC_SQRx寄存器的值；若使用HAL，检查HAL_ADC_ConfigChannel()中Rank参数是否按顺序设置。
验证DMA缓冲区长度：确保DMA传输长度等于扫描序列长度，避免数据覆盖或截断。
打印原始数据：将已知电压信号接入各通道，观察DMA缓冲区数据与通道的对应关系，快速定位错位位置。

解决方案一：正确配置扫描序列（推荐）

最根本的解决方法是确保ADC扫描序列的顺序与期望的DMA缓冲区顺序一致。在CubeMX中，直接调整Rank顺序即可；在代码中，按顺序调用配置函数。

CubeMX配置步骤

在ADC配置界面，使能“Scan Conversion Mode”和“Continuous Conversion Mode”（按需）。
在“Rank”列表中，按期望顺序添加通道。例如期望顺序为通道0、1、2、3，则Rank1=通道0，Rank2=通道1，以此类推。
使能DMA连续请求，并配置DMA为循环模式，数据宽度为半字（16位）。

代码示例（HAL库）

// 假设使用ADC1，DMA缓冲区adc_buf[4]
ADC_ChannelConfTypeDef sConfig = {0};

// 按顺序配置Rank1~Rank4
sConfig.Channel = ADC_CHANNEL_0;
sConfig.Rank = 1;
sConfig.SamplingTime = ADC_SAMPLETIME_84CYCLES;
HAL_ADC_ConfigChannel(&hadc1, &sConfig);

sConfig.Channel = ADC_CHANNEL_1;
sConfig.Rank = 2;
HAL_ADC_ConfigChannel(&hadc1, &sConfig);

sConfig.Channel = ADC_CHANNEL_2;
sConfig.Rank = 3;
HAL_ADC_ConfigChannel(&hadc1, &sConfig);

sConfig.Channel = ADC_CHANNEL_3;
sConfig.Rank = 4;
HAL_ADC_ConfigChannel(&hadc1, &sConfig);

// 启动DMA和ADC
HAL_ADC_Start_DMA(&hadc1, (uint32_t*)adc_buf, 4);

这样adc_buf[0]对应通道0，adc_buf[1]对应通道1，顺序完全匹配。

解决方案二：软件重排（适用于无法修改硬件配置的场景）

若因历史代码或硬件限制无法调整扫描序列，可在DMA传输完成后对缓冲区数据进行重排。需要先通过实验或已知序列确定实际映射关系。

重排代码示例

假设实际扫描序列为通道2、0、3、1（Rank1=2, Rank2=0, Rank3=3, Rank4=1），但期望顺序为0、1、2、3。则重排映射为：

// 实际DMA缓冲区: adc_raw[0]=ch2, adc_raw[1]=ch0, adc_raw[2]=ch3, adc_raw[3]=ch1
// 期望缓冲区: adc_ordered[0]=ch0, adc_ordered[1]=ch1, adc_ordered[2]=ch2, adc_ordered[3]=ch3

uint16_t adc_raw[4];
uint16_t adc_ordered[4];

// 在DMA传输完成回调中重排
void HAL_ADC_ConvCpltCallback(ADC_HandleTypeDef* hadc) {
    if (hadc->Instance == ADC1) {
        adc_ordered[0] = adc_raw[1]; // ch0
        adc_ordered[1] = adc_raw[3]; // ch1
        adc_ordered[2] = adc_raw[0]; // ch2
        adc_ordered[3] = adc_raw[2]; // ch3
    }
}

此方法简单但增加CPU开销，且需确保映射关系正确。

注意事项

序列长度与DMA长度必须一致：否则会导致数据错位或DMA传输错误。
采样时间配置：不同通道可独立设置采样时间，但需确保总转换时间满足DMA传输节奏。
ADC校准：上电后执行HAL_ADCEx_Calibration_Start()，避免首次转换数据异常。
DMA循环模式：若使用循环模式，重排操作需在每次传输完成回调中执行，或使用双缓冲区。
多ADC场景：若使用ADC1/ADC2同步模式，需分别检查各ADC的序列配置。
调试技巧：可先将所有通道接同一电压，通过数据是否一致快速判断是否存在顺序问题。

总结

ADC多通道DMA扫描模式下的通道顺序错乱，本质是扫描序列顺序与DMA缓冲区索引的映射关系未按预期配置。通过正确设置Rank顺序（方案一）可从根本上解决；若无法修改配置，软件重排（方案二）是有效的补救措施。理解ADC序列与DMA的对应关系，是避免此类问题的关键。

STM32 HAL库ADC多通道DMA扫描模式通道顺序错乱的排查与重排方案