一、问题现象与背景

在使用STM32 HAL库配置ADC多通道DMA扫描模式时，很多开发者会遇到采样数据与通道顺序不匹配的现象。例如配置了IN0、IN1、IN2三个通道，期望DMA缓冲区依次存放通道0、1、2的数据，但实际读到的顺序可能是通道1、2、0，或者每次上电顺序随机变化。这种错乱会导致后续数据处理完全错误，尤其在对顺序敏感的传感器采样场景中影响巨大。

二、原理讲解：ADC扫描与DMA传输机制

2.1 ADC规则组扫描序列

STM32的ADC支持规则组（Regular Group）多通道扫描。通过ADC_ChannelConfTypeDef中的Rank参数指定每个通道在序列中的位置，Rank值从1开始，数值越小越先转换。例如：

sConfig.Rank = ADC_REGULAR_RANK_1; // 第一个转换
sConfig.Channel = ADC_CHANNEL_0;

HAL库在HAL_ADC_ConfigChannel()中会写入SQR1/SQR2/SQR3寄存器，设置规则序列长度和每个Rank对应的通道。

2.2 DMA请求与传输

ADC规则组转换完成后产生DMA请求，DMA将ADC->DR寄存器中的数据搬运到用户缓冲区。在扫描模式下，每次转换结束都会触发DMA，因此DMA缓冲区中数据的顺序理论上应与Rank顺序一致。

2.3 常见错乱原因

Rank配置错误：多个通道使用了相同的Rank值，导致序列被覆盖。
DMA缓冲区对齐问题：ADC数据为12位右对齐，若DMA配置为半字（16位）传输，但缓冲区定义为8位，会造成数据错位。
HAL库初始化顺序：先启动DMA再启动ADC，或未正确调用HAL_ADC_Start_DMA()。
ADC校准未完成：未执行HAL_ADCEx_Calibration_Start()，导致转换结果不稳定。
DMA循环模式与中断冲突：循环模式下未及时处理数据，新旧数据混杂。
多ADC或过采样干扰：未考虑ADC时钟分频与采样时间，导致通道间串扰。

三、配置步骤（基于CubeMX）

在Pinout中启用ADC1的多个通道（如IN0、IN1、IN2）。
在ADC1参数设置中：
- Mode：Scan Conversion Mode 使能。
- Continuous Conversion Mode 根据需求选择（单次或连续）。
- DMA Continuous Requests 使能。
- Number Of Conversion 设置为通道数（如3）。
在Rank配置中，依次为每个通道分配唯一的Rank（1、2、3），并设置采样时间。
在DMA Settings中添加ADC1的DMA请求，模式选择Circular或Normal，数据宽度为Half Word（16位）。
生成代码后，在main.c中调用HAL_ADC_Start_DMA()启动转换。

四、完整代码示例

/* 定义缓冲区，长度=通道数 */
#define ADC_CHANNELS 3
uint16_t adc_buffer[ADC_CHANNELS];

/* ADC初始化函数（CubeMX生成，此处仅示意关键部分） */
void MX_ADC1_Init(void)
{
  ADC_ChannelConfTypeDef sConfig = {0};
  hadc1.Instance = ADC1;
  hadc1.Init.ScanConvMode = ADC_SCAN_ENABLE;
  hadc1.Init.ContinuousConvMode = ENABLE;
  hadc1.Init.DiscontinuousConvMode = DISABLE;
  hadc1.Init.ExternalTrigConv = ADC_SOFTWARE_START;
  hadc1.Init.DataAlign = ADC_DATAALIGN_RIGHT;
  hadc1.Init.NbrOfConversion = ADC_CHANNELS;
  hadc1.Init.DMAContinuousRequests = ENABLE;
  hadc1.Init.EOCSelection = ADC_EOC_SEQ_CONV;
  HAL_ADC_Init(&hadc1);

  /* 通道0，Rank1 */
  sConfig.Channel = ADC_CHANNEL_0;
  sConfig.Rank = ADC_REGULAR_RANK_1;
  sConfig.SamplingTime = ADC_SAMPLETIME_28CYCLES;
  HAL_ADC_ConfigChannel(&hadc1, &sConfig);

  /* 通道1，Rank2 */
  sConfig.Channel = ADC_CHANNEL_1;
  sConfig.Rank = ADC_REGULAR_RANK_2;
  HAL_ADC_ConfigChannel(&hadc1, &sConfig);

  /* 通道2，Rank3 */
  sConfig.Channel = ADC_CHANNEL_2;
  sConfig.Rank = ADC_REGULAR_RANK_3;
  HAL_ADC_ConfigChannel(&hadc1, &sConfig);
}

/* DMA初始化（CubeMX生成） */
void MX_DMA_Init(void)
{
  __HAL_RCC_DMA1_CLK_ENABLE();
  HAL_NVIC_SetPriority(DMA1_Channel1_IRQn, 0, 0);
  HAL_NVIC_EnableIRQ(DMA1_Channel1_IRQn);
}

/* 主函数中启动 */
int main(void)
{
  HAL_Init();
  SystemClock_Config();
  MX_GPIO_Init();
  MX_DMA_Init();
  MX_ADC1_Init();

  /* 校准ADC */
  HAL_ADCEx_Calibration_Start(&hadc1);

  /* 启动ADC DMA转换 */
  HAL_ADC_Start_DMA(&hadc1, (uint32_t*)adc_buffer, ADC_CHANNELS);

  while (1)
  {
    /* 数据处理：adc_buffer[0]对应通道0，[1]对应通道1，[2]对应通道2 */
    HAL_Delay(100);
  }
}

五、采样顺序错乱的排查与重排技巧

5.1 排查步骤

检查Rank配置：使用调试器查看ADC1->SQR1、SQR2、SQR3寄存器，确认每个Rank对应的通道号是否正确。
验证DMA传输宽度：确保DMA外设数据宽度与内存数据宽度均为Half Word，且缓冲区类型为uint16_t。
确认启动顺序：先调用HAL_ADCEx_Calibration_Start()，再调用HAL_ADC_Start_DMA()。
观察EOC标志：在DMA中断中检查ADC_FLAG_EOC，确认每次转换完成。
使用单次转换测试：将ContinuousConvMode设为DISABLE，手动触发一次转换，观察缓冲区数据顺序。

5.2 软件重排技巧

如果硬件配置无法修改或存在固定偏移，可在软件中重排。例如发现实际顺序为通道1、2、0，可定义映射表：

const uint8_t channel_map[ADC_CHANNELS] = {1, 2, 0}; // 实际顺序到期望顺序的索引
uint16_t sorted_buffer[ADC_CHANNELS];

void reorder_adc_data(uint16_t *src, uint16_t *dst, const uint8_t *map, uint8_t len)
{
  for (uint8_t i = 0; i < len; i++)
  {
    dst[map[i]] = src[i];
  }
}

调用reorder_adc_data(adc_buffer, sorted_buffer, channel_map, ADC_CHANNELS);后，sorted_buffer[0]即为通道0数据。

5.3 硬件校准与配置优化

确保每个通道的采样时间足够长（至少28个周期），避免通道间串扰。
在HAL_ADC_ConfigChannel()之后调用HAL_ADCEx_Calibration_Start()。
若使用过采样，需在CubeMX中正确设置过采样比率和移位，否则数据顺序可能被打乱。
对于高精度场景，建议在DMA传输完成后关闭ADC，重新配置序列再启动，避免连续模式下的累积误差。

六、注意事项

Rank必须唯一且连续：从1开始，不能跳过或重复。
DMA缓冲区大小：必须等于规则组转换通道数，否则会溢出。
中断优先级：若使用DMA中断，确保优先级合理，避免数据覆盖。
电压基准：确保VREF+稳定，否则所有通道数据均不准确。
调试技巧：可在DMA完成回调中打印缓冲区内容，快速定位顺序问题。

通过以上排查与重排方法，可有效解决STM32 HAL库ADC多通道DMA扫描模式的采样顺序错乱问题，提升系统可靠性。

STM32 HAL库ADC多通道DMA扫描模式采样顺序错乱排查与重排技巧