STM32 HAL库下ADC多通道DMA采样通道顺序错乱的根因与修复

1. 问题现象

使用STM32 HAL库配置ADC多通道扫描+DMA传输时,经常发现采集到的数据与预期通道顺序不符。例如配置了IN1、IN2、IN3三个通道,DMA缓冲区却收到IN2、IN3、IN1的数据,或者数据整体偏移一位。这种错乱在高速采样或通道数较多时尤为明显。

2. 根因分析

2.1 ADC扫描模式与DMA请求的时序

STM32的ADC在扫描模式下,每个通道转换完成后产生一次DMA请求。DMA控制器将ADC->DR寄存器的值搬运到内存。如果DMA配置为循环模式且缓冲区大小与通道数不匹配,或者DMA传输未及时完成,就会导致数据覆盖或错位。

2.2 HAL库的HAL_ADC_Start_DMA参数陷阱

HAL_ADC_Start_DMA(ADC_HandleTypeDef *hadc, uint32_t *pData, uint32_t Length) 的Length参数是传输次数,而非字节数。对于16位ADC数据,若误将字节数传入,会导致DMA提前停止或缓冲区越界。

2.3 规则组通道顺序配置错误

在CubeMX或手动代码中,ADC_ChannelConfTypeDef的Rank成员决定转换顺序。若多个通道的Rank值重复或未按顺序设置,ADC会按默认顺序转换,导致DMA接收顺序与预期不符。

2.4 内存对齐与数据宽度不匹配

DMA外设数据宽度(ADC_DR为16位)与内存数据宽度(uint16_t)必须一致。若内存定义为uint8_t数组,DMA会按半字传输,造成数据拼接错误。

3. 正确配置步骤

3.1 CubeMX配置要点

  • 启用ADC的Scan Conversion Mode。
  • 设置Number of Conversion为实际通道数。
  • 为每个通道分配唯一的Rank(从1开始递增)。
  • 启用DMA Continuous Requests,DMA模式选择Circular。
  • DMA数据宽度:外设和内存均设为Half Word(16位)。

3.2 代码初始化与启动

#define ADC_CH_NUM 3
uint16_t adc_buf[ADC_CH_NUM];

void ADC_Init(void)
{
    ADC_ChannelConfTypeDef sConfig = {0};

    hadc1.Instance = ADC1;
    hadc1.Init.ScanConvMode = 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_CH_NUM;
    HAL_ADC_Init(&hadc1);

    sConfig.Channel = ADC_CHANNEL_1;
    sConfig.Rank = 1;
    sConfig.SamplingTime = ADC_SAMPLETIME_28CYCLES;
    HAL_ADC_ConfigChannel(&hadc1, &sConfig);

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

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

    // 启动DMA,Length为通道数
    HAL_ADC_Start_DMA(&hadc1, (uint32_t*)adc_buf, ADC_CH_NUM);
}

3.3 DMA配置(手动方式)

若未使用CubeMX,需确保DMA句柄正确关联:

__HAL_LINKDMA(&hadc1, DMA_Handle, hdma_adc1);

hdma_adc1.Instance = DMA1_Channel1;
hdma_adc1.Init.Direction = DMA_PERIPH_TO_MEMORY;
hdma_adc1.Init.PeriphInc = DMA_PINC_DISABLE;
hdma_adc1.Init.MemInc = DMA_MINC_ENABLE;
hdma_adc1.Init.PeriphDataAlignment = DMA_PDATAALIGN_HALFWORD;
hdma_adc1.Init.MemDataAlignment = DMA_MDATAALIGN_HALFWORD;
hdma_adc1.Init.Mode = DMA_CIRCULAR;
hdma_adc1.Init.Priority = DMA_PRIORITY_HIGH;
HAL_DMA_Init(&hdma_adc1);

4. 修复与验证

4.1 检查Rank唯一性

在HAL_ADC_ConfigChannel后,读取ADC_CFGR1寄存器的SQ1[4:0]等位,确认每个Rank对应的通道号正确。

4.2 使用回调函数验证顺序

在DMA传输完成回调中打印缓冲区数据,与已知电压对比:

void HAL_ADC_ConvCpltCallback(ADC_HandleTypeDef *hadc)
{
    // adc_buf[0]对应Rank1通道,以此类推
    printf("CH1:%d, CH2:%d, CH3:%d\n", adc_buf[0], adc_buf[1], adc_buf[2]);
}

4.3 常见错误修复

  • 错误1:HAL_ADC_Start_DMA的Length传入sizeof(adc_buf)(字节数)。修复:改为ADC_CH_NUM。
  • 错误2:DMA内存地址未对齐。修复:使用__attribute__((aligned(4)))修饰缓冲区。
  • 错误3:连续转换模式下未清除EOC标志。HAL库已处理,但需确保中断优先级合理。

5. 注意事项

  • 多通道扫描时,必须启用DMA,否则ADC_DR会被覆盖。
  • 若使用过采样,需调整DMA数据宽度为32位。
  • 在调试时,可先禁用DMA,用轮询方式读取每个通道,确认Rank配置正确后再启用DMA。
  • 对于STM32F1系列,ADC_DR为16位右对齐,DMA内存必须为uint16_t。
  • 避免在DMA传输过程中修改ADC通道配置,否则会导致数据错乱。

通过以上分析与配置,可彻底解决HAL库下ADC多通道DMA采样的通道顺序错乱问题,确保数据与通道一一对应。