stm32f0xx hal adc.h

在STM32F0xx系列微控制器中，adc.h是STM32 HAL库（硬件抽象层）中用于管理ADC（模数转换器）外设的头文件。它提供了配置、启动和管理ADC转换的API函数和数据结构。以下是关键内容的总结：

1. 主要功能

初始化ADC：配置ADC的工作模式、分辨率、对齐方式、采样时间等。
启动/停止转换：支持单次、连续、扫描或间断模式。
数据获取：读取ADC转换结果。
中断/DMA支持：通过中断或DMA传输数据。
校准：提供ADC校准函数，确保转换精度。

2. 关键数据结构

ADC_HandleTypeDef：ADC实例的句柄，包含配置参数和状态。

typedef struct {
ADC_TypeDef *Instance;     // ADC寄存器基地址（如ADC1）
ADC_InitTypeDef Init;      // ADC初始化配置
DMA_HandleTypeDef *DMA_Handle; // DMA句柄（若使用DMA）
HAL_LockTypeDef Lock;      // 资源锁
__IO uint32_t State;       // ADC状态（如HAL_ADC_STATE_READY）
} ADC_HandleTypeDef;

ADC_InitTypeDef：ADC初始化参数。

typedef struct {
uint32_t ClockPrescaler;        // 时钟分频（如ADC_CLOCK_SYNC_PCLK_DIV2）
uint32_t Resolution;            // 分辨率（如ADC_RESOLUTION_12B）
uint32_t DataAlign;             // 数据对齐（左对齐/右对齐）
uint32_t ScanDirection;         // 扫描方向（正向/反向）
uint32_t ExternalTrigConvEdge;  // 外部触发边沿（如上升沿触发）
uint32_t ExternalTrigConv;      // 外部触发源（如TIM触发）
uint32_t ContinuousConvMode;    // 连续转换模式（ENABLE/DISABLE）
uint32_t DMAContinuousRequests; // DMA连续请求（ENABLE/DISABLE）
} ADC_InitTypeDef;

3. 常用函数

初始化与反初始化：

HAL_StatusTypeDef HAL_ADC_Init(ADC_HandleTypeDef *hadc);
HAL_StatusTypeDef HAL_ADC_DeInit(ADC_HandleTypeDef *hadc);

校准：

HAL_StatusTypeDef HAL_ADCEx_Calibration_Start(ADC_HandleTypeDef *hadc);

启动/停止转换：

HAL_StatusTypeDef HAL_ADC_Start(ADC_HandleTypeDef *hadc);          // 阻塞模式
HAL_StatusTypeDef HAL_ADC_Start_IT(ADC_HandleTypeDef *hadc);       // 中断模式
HAL_StatusTypeDef HAL_ADC_Start_DMA(ADC_HandleTypeDef *hadc, uint32_t *pData, uint32_t Length); // DMA模式
HAL_StatusTypeDef HAL_ADC_Stop(ADC_HandleTypeDef *hadc);

获取数据：

uint32_t HAL_ADC_GetValue(ADC_HandleTypeDef *hadc);  // 读取转换结果

中断处理：

void HAL_ADC_IRQHandler(ADC_HandleTypeDef *hadc);    // ADC中断服务函数

4. 使用示例

单通道单次转换（阻塞模式）

// 1. 初始化ADC
ADC_HandleTypeDef hadc;
hadc.Instance = ADC1;
hadc.Init.ClockPrescaler = ADC_CLOCK_SYNC_PCLK_DIV4;
hadc.Init.Resolution = ADC_RESOLUTION_12B;
hadc.Init.DataAlign = ADC_DATAALIGN_RIGHT;
hadc.Init.ScanDirection = ADC_SCAN_DIRECTION_FORWARD;
hadc.Init.ContinuousConvMode = DISABLE;  // 单次模式
HAL_ADC_Init(&hadc);

// 2. 校准ADC
HAL_ADCEx_Calibration_Start(&hadc);

// 3. 配置通道（如通道0）
ADC_ChannelConfTypeDef sConfig = {0};
sConfig.Channel = ADC_CHANNEL_0;
sConfig.Rank = ADC_RANK_CHANNEL_NUMBER;
sConfig.SamplingTime = ADC_SAMPLETIME_55CYCLES_5;
HAL_ADC_ConfigChannel(&hadc, &sConfig);

// 4. 启动转换并读取数据
HAL_ADC_Start(&hadc);
if (HAL_ADC_PollForConversion(&hadc, 100) == HAL_OK) {
  uint16_t adc_value = HAL_ADC_GetValue(&hadc);
}