stm32 adc hal

### STM32 ADC HAL 库使用教程

#### 初始化配置
为了简化开发过程，可以利用STM32CubeMX这样的图形化工具完成初步设置。通过该工具能够快速生成初始化代码框架，包括使能时钟、配置引脚等功能[^1]。

对于ADC模块而言，在实际编程前需先定义好所需的参数结构体`ADC_HandleTypeDef hadc`，并调用相应的初始化函数：

// 定义全局变量用于存储ADC句柄
extern ADC_HandleTypeDef hadc;

// 调用初始化函数
if (HAL_ADC_Init(&hadc) != HAL_OK){
    // 错误处理逻辑
}

#### 启动转换
当一切准备就绪之后，就可以启动一次性的单次模式转换或是连续模式下的多次采样了。这里给出两种不同工作方式的例子：

##### 单次模式
适用于只需要获取当前时刻模拟量值的情况：

uint32_t adc_value;
if(HAL_ADC_Start(&hadc) != HAL_OK || \
   HAL_ADC_PollForConversion(&hadc, 100) != HAL_OK ||\
   HAL_ADC_Stop(&hadc)!= HAL_OK){
       // 处理错误情况
}

adc_value = HAL_ADC_GetValue(&hadc);

##### 连续模式配合DMA传输
适合于持续不断地收集数据流的应用场景，比如音频信号捕捉等场合下非常有用。这种方式不仅提高了效率还减轻了CPU负担：

uint16_t buffer[BUFFER_SIZE];

// 配置DMA通道并将缓冲区地址传入
__HAL_LINKDMA(&hadc,DMA_Handle,hadma_adc);

if(HAL_ADC_Start_DMA(&hadc,(uint32_t*)buffer,BUFFER_SIZE/sizeof(uint32_t))!= HAL_OK){
      // 如果失败则执行相应措施
}

上述操作实现了基于DMA的高效批量读取机制，每次触发中断表示一组完整的样本已被成功转移到内存中等待后续分析处理。