当前位置:   article > 正文

A4 STM32_HAL库函数 之 ADC扩展驱动器所有函数的介绍及使用

A4 STM32_HAL库函数 之 ADC扩展驱动器所有函数的介绍及使用

1 ADC扩展驱动器预览

序号函数名描述
1HAL_ADCEx_Calibration_Start()启动ADC校准。
2HAL_ADCEx_InjectedStart()启动注入模式的ADC转换。
3HAL_ADCEx_InjectedStop()停止注入模式的ADC转换。
4HAL_ADCEx_InjectedPollForConversion()轮询注入模式ADC转换是否完成。
5HAL_ADCEx_InjectedStart_IT()启动注入模式的ADC转换并使用中断处理转换完成。
6HAL_ADCEx_InjectedStop_IT()停止注入模式的ADC转换中断。
7HAL_ADCEx_MultiModeStart_DMA()启动多模式DMA传输。
8HAL_ADCEx_MultiModeStop_DMA()停止多模式DMA传输。
9HAL_ADCEx_InjectedGetValue()获取注入模式的最近一次ADC转换结果。
10HAL_ADCEx_MultiModeGetValue()获取多模式的最近一次ADC转换结果。
11HAL_ADCEx_InjectedConvCpltCallback()注入模式的ADC转换完成回调函数。
12HAL_ADCEx_InjectedConfigChannel()配置注入模式ADC通道。
13HAL_ADCEx_MultiModeConfigChannel()配置多模式ADC通道。

使用模板:

#include "stm32f4xx_hal.h"

int main(void) {
    // HAL初始化
    HAL_Init();
    
    // 初始化MCU外设相关的引脚或资源
    HAL_MspInit();
    
    // 初始化HAL的时基
    HAL_InitTick();
    
    // 初始化ADC外设
    HAL_ADC_Init();
    
    // 启动ADC校准
    HAL_ADCEx_Calibration_Start();
    
    // 启动注入模式的ADC转换
    HAL_ADCEx_InjectedStart();
    
    // 等待注入模式转换完成
    while (HAL_ADCEx_InjectedPollForConversion() != HAL_OK);
    
    // 获取注入模式转换结果
    uint32_t injectedValue = HAL_ADCEx_InjectedGetValue();
    
    // 进行其他操作...
    
    // 停止注入模式的ADC转换
    HAL_ADCEx_InjectedStop();
    
    // 反初始化ADC外设
    HAL_ADC_DeInit();
    
    // 反初始化MCU外设相关的引脚或资源
    HAL_MspDeInit();
    
    return 0;
}
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40

1.1 HAL_ADCEx_Calibration_Start

函数名HAL_ADCEx_Calibration_Start
函数原形HAL_StatusTypeDef HAL_ADCEx_Calibration_Start(ADC_HandleTypeDef* hadc, uint32_t SingleDiff)
功能描述启动 ADC 校准
输入参数 1hadc:ADC 句柄,指向一个 ADC_HandleTypeDef 结构体
输入参数 2SingleDiff:校准模式,可以是 ADC_SINGLE_ENDED 或 ADC_DIFFERENTIAL
输出参数
返回值HAL_StatusTypeDef:校准启动结果,可以是 HAL_OK 或 HAL_ERROR
先决条件
被调用函数

1.2 HAL_ADCEx_InjectedStart

函数名HAL_ADCEx_InjectedStart
函数原形HAL_StatusTypeDef HAL_ADCEx_InjectedStart(ADC_HandleTypeDef* hadc)
功能描述启动注入模式的 ADC 转换
输入参数hadc:ADC 句柄,指向一个 ADC_HandleTypeDef 结构体
输出参数
返回值HAL_StatusTypeDef:启动结果,可以是 HAL_OK 或 HAL_ERROR
先决条件
被调用函数

1.3 HAL_ADCEx_InjectedStop

函数名HAL_ADCEx_InjectedStop
函数原形HAL_StatusTypeDef HAL_ADCEx_InjectedStop(ADC_HandleTypeDef* hadc)
功能描述停止注入模式的 ADC 转换
输入参数hadc:ADC 句柄,指向一个 ADC_HandleTypeDef 结构体
输出参数
返回值HAL_StatusTypeDef:停止结果,可以是 HAL_OK 或 HAL_ERROR
先决条件
被调用函数

1.4 HAL_ADCEx_InjectedPollForConversion

函数名HAL_ADCEx_InjectedPollForConversion
函数原形HAL_StatusTypeDef HAL_ADCEx_InjectedPollForConversion(ADC_HandleTypeDef* hadc, uint32_t Timeout)
功能描述轮询注入模式的 ADC 转换完成状态
输入参数 1hadc:ADC 句柄,指向一个 ADC_HandleTypeDef 结构体
输入参数 2Timeout:轮询超时时间,单位为毫秒
输出参数
返回值HAL_StatusTypeDef:操作结果,可以是 HAL_OK、HAL_TIMEOUT 或 HAL_ERROR
先决条件
被调用函数

1.5 HAL_ADCEx_InjectedStart_IT

函数名HAL_ADCEx_InjectedStart_IT
函数原形HAL_StatusTypeDef HAL_ADCEx_InjectedStart_IT(ADC_HandleTypeDef* hadc)
功能描述以中断方式启动注入模式的 ADC 转换
输入参数hadc:ADC 句柄,指向一个 ADC_HandleTypeDef 结构体
输出参数
返回值HAL_StatusTypeDef:启动结果,可以是 HAL_OK 或 HAL_ERROR
先决条件
被调用函数

1.6 HAL_ADCEx_InjectedStop_IT

函数名HAL_ADCEx_InjectedStop_IT
函数原形HAL_StatusTypeDef HAL_ADCEx_InjectedStop_IT(ADC_HandleTypeDef* hadc)
功能描述以中断方式停止注入模式的 ADC 转换
输入参数hadc:ADC 句柄,指向一个 ADC_HandleTypeDef 结构体
输出参数
返回值HAL_StatusTypeDef:停止结果,可以是 HAL_OK 或 HAL_ERROR
先决条件
被调用函数

1.7 HAL_ADCEx_MultiModeStart_DMA

函数名HAL_ADCEx_MultiModeStart_DMA
函数原形HAL_StatusTypeDef HAL_ADCEx_MultiModeStart_DMA(ADC_HandleTypeDef* hadc, uint32_t* pData, uint32_t Length)
功能描述启动多模式 DMA 传输
输入参数 1hadc:ADC 句柄,指向一个 ADC_HandleTypeDef 结构体
输入参数 2pData:要传输的

数据缓冲区的指针 |
| 输入参数 3 | Length:要传输的数据数量 |
| 输出参数 | 无 |
| 返回值 | HAL_StatusTypeDef:启动结果,可以是 HAL_OK 或 HAL_ERROR |
| 先决条件 | 无 |
| 被调用函数 | 无 |


1.8 HAL_ADCEx_MultiModeStop_DMA

函数名HAL_ADCEx_MultiModeStop_DMA
函数原形HAL_StatusTypeDef HAL_ADCEx_MultiModeStop_DMA(ADC_HandleTypeDef* hadc)
功能描述停止多模式 DMA 传输
输入参数hadc:ADC 句柄,指向一个 ADC_HandleTypeDef 结构体
输出参数
返回值HAL_StatusTypeDef:停止结果,可以是 HAL_OK 或 HAL_ERROR
先决条件
被调用函数

1.9 HAL_ADCEx_InjectedGetValue

函数名HAL_ADCEx_InjectedGetValue
函数原形uint32_t HAL_ADCEx_InjectedGetValue(ADC_HandleTypeDef* hadc, uint32_t InjectedRank)
功能描述获取注入模式的 ADC 转换结果值
输入参数 1hadc:ADC 句柄,指向一个 ADC_HandleTypeDef 结构体
输入参数 2InjectedRank:注入通道的秩(从 1 开始)
输出参数
返回值uint32_t:转换结果值
先决条件
被调用函数

1.10 HAL_ADCEx_MultiModeGetValue

函数名HAL_ADCEx_MultiModeGetValue
函数原形uint32_t HAL_ADCEx_MultiModeGetValue(ADC_HandleTypeDef* hadc)
功能描述获取多模式的 ADC 转换结果值
输入参数hadc:ADC 句柄,指向一个 ADC_HandleTypeDef 结构体
输出参数
返回值uint32_t:转换结果值
先决条件
被调用函数

1.11 HAL_ADCEx_InjectedConvCpltCallback

函数名HAL_ADCEx_InjectedConvCpltCallback
函数原形void HAL_ADCEx_InjectedConvCpltCallback(ADC_HandleTypeDef* hadc)
功能描述注入模式的 ADC 转换完成回调函数
输入参数hadc:ADC 句柄,指向一个 ADC_HandleTypeDef 结构体
输出参数
返回值
先决条件
被调用函数

1.12 HAL_ADCEx_InjectedConfigChannel

函数名HAL_ADCEx_InjectedConfigChannel
函数原形HAL_StatusTypeDef HAL_ADCEx_InjectedConfigChannel(ADC_HandleTypeDef* hadc, ADC_InjectionConfTypeDef* sConfigInjected)
功能描述配置注入模式的 ADC 通道
输入参数 1hadc:ADC 句柄,指向一个 ADC_HandleTypeDef 结构体
输入参数 2sConfigInjected:注入模式通道配置结构体,包含通道号、采样时间等配置信息
输出参数
返回值HAL_StatusTypeDef:配置结果,可以是 HAL_OK 或 HAL_ERROR
先决条件
被调用函数

1.13 HAL_ADCEx_MultiModeConfigChannel

函数名HAL_ADCEx_MultiModeConfigChannel
函数原形HAL_StatusTypeDef HAL_ADCEx_MultiModeConfigChannel(ADC_HandleTypeDef* hadc, ADC_MultiModeTypeDef* multimode)
功能描述配置多模式的 ADC 通道
输入参数 1hadc:ADC 句柄,指向一个 ADC_HandleTypeDef 结构体
输入参数 2multimode:多模式配置结构体,包含主模式和注入模式的配置信息
输出参数
返回值HAL_StatusTypeDef:配置结果,可以是 HAL_OK 或 HAL_ERROR
先决条件
被调用函数

该文档修改记录:

修改时间修改说明
2024年4月7日第一次发布,介绍了A4 STM32_HAL库函数 之 ADC扩展驱动器所有函数的介绍及使用

总结

以上就是A4 STM32_HAL库函数 之 ADC扩展驱动器所有函数的介绍及使用的内容。
有不明白的地方欢迎留言;有建议欢迎留言,我后面编写文档好改进。
创作不容,如果文档对您有帮助,记得给个赞。

声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/不正经/article/detail/405248
推荐阅读
相关标签
  

闽ICP备14008679号