ADC 输入输出操作函数

ADC IO 操作函数。 更多...

函数
HAL_StatusTypeDef	HAL_ADC_Start (ADC_HandleTypeDef *hadc)
	使能 ADC，启动常规组转换。
HAL_StatusTypeDef	HAL_ADC_Stop (ADC_HandleTypeDef *hadc)
	停止常规组（以及在自动注入模式情况下的注入通道）的 ADC 转换，禁用 ADC 外设。
HAL_StatusTypeDef	HAL_ADC_PollForConversion (ADC_HandleTypeDef *hadc, uint32_t Timeout)
	等待常规组转换完成。
HAL_StatusTypeDef	HAL_ADC_PollForEvent (ADC_HandleTypeDef *hadc, uint32_t EventType, uint32_t Timeout)
	轮询 ADC 事件。
HAL_StatusTypeDef	HAL_ADC_Start_IT (ADC_HandleTypeDef *hadc)
	使能 ADC，启动常规组转换并启用中断。
HAL_StatusTypeDef	HAL_ADC_Stop_IT (ADC_HandleTypeDef *hadc)
	停止常规组（以及在自动注入模式情况下的注入组）的 ADC 转换，禁用转换结束中断，禁用 ADC 外设。
HAL_StatusTypeDef	HAL_ADC_Start_DMA (ADC_HandleTypeDef *hadc, uint32_t *pData, uint32_t Length)
	使能 ADC，启动常规组转换并通过 DMA 传输结果。
HAL_StatusTypeDef	HAL_ADC_Stop_DMA (ADC_HandleTypeDef *hadc)
	停止常规组（以及在自动注入模式情况下的注入组）的 ADC 转换，禁用 ADC DMA 传输，禁用 ADC 外设。
uint32_t	HAL_ADC_GetValue (const ADC_HandleTypeDef *hadc)
	获取 ADC 常规组转换结果。
HAL_StatusTypeDef	HAL_ADC_StartSampling (ADC_HandleTypeDef *hadc)
	启动常规组的 ADC 转换采样阶段。
HAL_StatusTypeDef	HAL_ADC_StopSampling (ADC_HandleTypeDef *hadc)
	停止常规组的 ADC 转换采样阶段并启动转换。
void	HAL_ADC_IRQHandler (ADC_HandleTypeDef *hadc)
	处理 ADC 中断请求。
__weak void	HAL_ADC_ConvCpltCallback (ADC_HandleTypeDef *hadc)
	非阻塞模式下的转换完成回调函数。
__weak void	HAL_ADC_ConvHalfCpltCallback (ADC_HandleTypeDef *hadc)
	非阻塞模式下的转换 DMA 半传输回调函数。
__weak void	HAL_ADC_LevelOutOfWindowCallback (ADC_HandleTypeDef *hadc)
	非阻塞模式下的模拟看门狗 1 回调函数。
__weak void	HAL_ADC_ErrorCallback (ADC_HandleTypeDef *hadc)
	非阻塞模式下的 ADC 错误回调函数（带中断的 ADC 转换或通过 DMA 传输）。

---

详细描述

ADC IO 操作函数。

IO 操作函数。

 ===============================================================================
                      ##### IO 操作函数 #####
 ===============================================================================
    [..]  本部分提供允许执行以下操作的函数：
      (+) 启动常规组转换。
      (+) 停止常规组转换。
      (+) 轮询常规组转换完成。
      (+) 轮询转换事件。
      (+) 获取常规通道转换结果。
      (+) 启动常规组转换并启用中断。
      (+) 停止常规组转换并禁用中断。
      (+) 处理 ADC 中断请求
      (+) 启动常规组转换并启用 DMA 传输。
      (+) 停止常规组转换并禁用 ADC DMA 传输。

---

函数文档

void HAL_ADC_ConvCpltCallback

(

ADC_HandleTypeDef *

hadc

)

非阻塞模式下的转换完成回调函数。

参数:

hadc

ADC 句柄

返回值:

无

定义位于文件 stm32g4xx_hal_adc.c 的 2662 行。

引用 UNUSED。

被 ADC_DMAConvCplt(), HAL_ADC_Init(), HAL_ADC_IRQHandler(), 和 HAL_ADC_UnRegisterCallback() 引用。

void HAL_ADC_ConvHalfCpltCallback

(

ADC_HandleTypeDef *

hadc

)

非阻塞模式下的转换 DMA 半传输回调函数。

参数:

hadc

ADC 句柄

返回值:

无

定义位于文件 stm32g4xx_hal_adc.c 的 2677 行。

引用 UNUSED。

被 ADC_DMAHalfConvCplt(), HAL_ADC_Init(), 和 HAL_ADC_UnRegisterCallback() 引用。

void HAL_ADC_ErrorCallback

(

ADC_HandleTypeDef *

hadc

)

非阻塞模式下的 ADC 错误回调函数（带中断的 ADC 转换或通过 DMA 传输）。

注意:

当使用带 DMA 传输的 ADC 时，若因溢出导致错误（HAL ADC 句柄参数 "ErrorCode" 状态为 "HAL_ADC_ERROR_OVR"）：

• 使用函数 "HAL_ADC_Stop_DMA()" 重新初始化 DMA。
• 如果需要，使用函数 "HAL_ADC_Start_DMA()" 重新启动新的 ADC 转换（此函数也会清除溢出标志）。

参数:

hadc

ADC 句柄

返回值:

无

定义位于文件 stm32g4xx_hal_adc.c 的 2714 行。

引用 UNUSED。

被 ADC_DMAConvCplt(), ADC_DMAError(), HAL_ADC_Init(), HAL_ADC_IRQHandler(), 和 HAL_ADC_UnRegisterCallback() 引用。

uint32_t HAL_ADC_GetValue

(

const ADC_HandleTypeDef *

hadc

)

获取 ADC 常规组转换结果。

注意:

读取寄存器 DR 会自动清除 ADC 标志 EOC（ADC 常规组单次转换结束）。

此函数不清除 ADC 标志 EOS（ADC 常规组序列转换结束）。EOS 标志上升沿的出现：

• 如果序列由 1 个等级组成，则 EOS 标志等同于 EOC 标志。
• 如果序列由多个等级组成，则扫描期间仅 EOC 标志置位，扫描序列结束时 EOC 和 EOS 标志均置位。要清除此标志，可通过以下方式：在 IT 编程模型中使用函数：HAL_ADC_IRQHandler()，在轮询编程模型中使用：HAL_ADC_PollForConversion() 或 __HAL_ADC_CLEAR_FLAG(&hadc, ADC_FLAG_EOS)。

参数:

hadc

ADC 句柄

返回值:

ADC

常规组转换数据

定义位于文件 stm32g4xx_hal_adc.c 的 2230 行。

引用 assert_param, 和 __ADC_HandleTypeDef::Instance。

void HAL_ADC_IRQHandler

(

ADC_HandleTypeDef *

hadc

)

处理 ADC 中断请求。

参数:

hadc

ADC 句柄

返回值:

无

定义位于文件