A9 STM32_HAL库函数 之 DAC通用驱动所有函数的介绍及使用
- [1 通用定时器(TIM)预览](#1 通用定时器(TIM)预览)
-
- [1.1 HAL_DAC_Init](#1.1 HAL_DAC_Init)
- [1.2 HAL_DAC_DeInit](#1.2 HAL_DAC_DeInit)
- [1.3 HAL_DAC_MspInit](#1.3 HAL_DAC_MspInit)
- [1.4 HAL_DAC_MspDeInit](#1.4 HAL_DAC_MspDeInit)
- [1.5 HAL_DAC_Start](#1.5 HAL_DAC_Start)
- [1.6 HAL_DAC_Stop](#1.6 HAL_DAC_Stop)
- [1.7 HAL_DAC_Start_DMA](#1.7 HAL_DAC_Start_DMA)
- [1.8 HAL_DAC_Stop_DMA](#1.8 HAL_DAC_Stop_DMA)
- [1.9 HAL_DAC_GetValue](#1.9 HAL_DAC_GetValue)
- [1.10 HAL_DAC_ConvCpltCallbackCh1](#1.10 HAL_DAC_ConvCpltCallbackCh1)
- [1.11 HAL_DAC_ConvHalfCpltCallbackCh1](#1.11 HAL_DAC_ConvHalfCpltCallbackCh1)
- [1.12 HAL_DAC_ErrorCallbackCh1](#1.12 HAL_DAC_ErrorCallbackCh1)
- [1.13 HAL_DAC_SetValue](#1.13 HAL_DAC_SetValue)
- [1.14 HAL_DAC_ConfigChannel](#1.14 HAL_DAC_ConfigChannel)
- [1.15 HAL_DAC_GetState](#1.15 HAL_DAC_GetState)
- [1.16 HAL_DAC_GetError](#1.16 HAL_DAC_GetError)
- 该文档修改记录:
- 总结
1 通用定时器(TIM)预览
序号 | 函数名 | 描述 |
---|---|---|
1 | HAL_DAC_Init() | 初始化DAC外设。 |
2 | HAL_DAC_DeInit() | 反初始化DAC外设。 |
3 | HAL_DAC_MspInit() | 初始化MCU外设相关的DAC引脚或资源。 |
4 | HAL_DAC_MspDeInit() | 反初始化MCU外设相关的DAC引脚或资源。 |
5 | HAL_DAC_Start() | 启动DAC转换。 |
6 | HAL_DAC_Stop() | 停止DAC转换。 |
7 | HAL_DAC_Start_DMA() | 启动DAC转换并使用DMA处理转换数据。 |
8 | HAL_DAC_Stop_DMA() | 停止DAC转换DMA。 |
9 | HAL_DAC_GetValue() | 获取最近一次DAC转换的结果。 |
10 | HAL_DAC_ConvCpltCallbackCh1() | DAC通道1转换完成回调函数。 |
11 | HAL_DAC_ConvHalfCpltCallbackCh1() | DAC通道1转换一半完成回调函数。 |
12 | HAL_DAC_ErrorCallbackCh1() | DAC通道1错误回调函数。 |
13 | HAL_DAC_SetValue() | 设置DAC转换值。 |
14 | HAL_DAC_ConfigChannel() | 配置DAC通道。 |
15 | HAL_DAC_GetState() | 获取DAC状态。 |
16 | HAL_DAC_GetError() | 获取DAC错误状态。 |
使用模板:
c
#include "stm32f4xx_hal.h"
int main(void) {
// HAL初始化
HAL_Init();
// 初始化MCU外设相关的引脚或资源
HAL_DAC_MspInit();
// 初始化DAC外设
HAL_DAC_Init();
// 启动DAC转换
HAL_DAC_Start();
// 进行其他操作...
// 获取最近一次DAC转换的结果
uint32_t dacValue = HAL_DAC_GetValue();
// 启动DAC转换并使用DMA处理转换数据
HAL_DAC_Start_DMA();
// DAC通道1转换完成回调函数
HAL_DAC_ConvCpltCallbackCh1();
// DAC通道1转换一半完成回调函数
HAL_DAC_ConvHalfCpltCallbackCh1();
// DAC通道1错误回调函数
HAL_DAC_ErrorCallbackCh1();
// 停止DAC转换
HAL_DAC_Stop();
// 反初始化DAC外设
HAL_DAC_DeInit();
// 反初始化MCU外设相关的引脚或资源
HAL_DAC_MspDeInit();
return 0;
}
1.1 HAL_DAC_Init
函数名 | HAL_DAC_Init |
---|---|
函数原形 | HAL_StatusTypeDef HAL_DAC_Init(DAC_HandleTypeDef* hdac) |
功能描述 | 初始化 DAC(数模转换)模块 |
输入参数 | hdac:DAC 句柄,指向一个 DAC_HandleTypeDef 结构体 |
输出参数 | 无 |
返回值 | HAL_StatusTypeDef:初始化结果,可以是 HAL_OK 或 HAL_ERROR |
先决条件 | 无 |
被调用函数 | 无 |
1.2 HAL_DAC_DeInit
函数名 | HAL_DAC_DeInit |
---|---|
函数原形 | HAL_StatusTypeDef HAL_DAC_DeInit(DAC_HandleTypeDef* hdac) |
功能描述 | 反初始化 DAC 模块 |
输入参数 | hdac:DAC 句柄,指向一个 DAC_HandleTypeDef 结构体 |
输出参数 | 无 |
返回值 | HAL_StatusTypeDef:反初始化结果,可以是 HAL_OK 或 HAL_ERROR |
先决条件 | 无 |
被调用函数 | 无 |
1.3 HAL_DAC_MspInit
函数名 | HAL_DAC_MspInit |
---|---|
函数原形 | void HAL_DAC_MspInit(DAC_HandleTypeDef* hdac) |
功能描述 | DAC 外设底层初始化,典型的用途是配置外设的时钟和引脚 |
输入参数 | hdac:DAC 句柄,指向一个 DAC_HandleTypeDef 结构体 |
输出参数 | 无 |
返回值 | 无 |
先决条件 | 无 |
被调用函数 | 无 |
1.4 HAL_DAC_MspDeInit
函数名 | HAL_DAC_MspDeInit |
---|---|
函数原形 | void HAL_DAC_MspDeInit(DAC_HandleTypeDef* hdac) |
功能描述 | DAC 外设底层反初始化,典型的用途是恢复外设的默认配置 |
输入参数 | hdac:DAC 句柄,指向一个 DAC_HandleTypeDef 结构体 |
输出参数 | 无 |
返回值 | 无 |
先决条件 | 无 |
被调用函数 | 无 |
1.5 HAL_DAC_Start
函数名 | HAL_DAC_Start |
---|---|
函数原形 | HAL_StatusTypeDef HAL_DAC_Start(DAC_HandleTypeDef* hdac, uint32_t Channel) |
功能描述 | 启动 DAC 转换 |
输入参数 1 | hdac:DAC 句柄,指向一个 DAC_HandleTypeDef 结构体 |
输入参数 2 | Channel:DAC 通道号,可以是 DAC_CHANNEL_1 或 DAC_CHANNEL_2 |
输出参数 | 无 |
返回值 | HAL_StatusTypeDef:启动结果,可以是 HAL_OK 或 HAL_ERROR |
先决条件 | 无 |
被调用函数 | 无 |
1.6 HAL_DAC_Stop
函数名 | HAL_DAC_Stop |
---|---|
函数原形 | HAL_StatusTypeDef HAL_DAC_Stop(DAC_HandleTypeDef* hdac, uint32_t Channel) |
功能描述 | 停止 DAC 转换 |
输入参数 1 | hdac:DAC 句柄,指向一个 DAC_HandleTypeDef 结构体 |
输入参数 2 | Channel:DAC 通道号,可以是 DAC_CHANNEL_1 或 DAC_CHANNEL_2 |
输出参数 | 无 |
返回值 | HAL_StatusTypeDef:停止结果,可以是 HAL_OK 或 HAL_ERROR |
先决条件 | 无 |
被调用函数 | 无 |
1.7 HAL_DAC_Start_DMA
函数名 | HAL_DAC_Start_DMA |
---|---|
函数原形 | HAL_StatusTypeDef HAL_DAC_Start_DMA(DAC_HandleTypeDef* hdac, uint32_t Channel, uint32_t* pData, uint32_t Length, uint32_t Alignment) |
功能描述 | 启动 DAC 转换,使用 DMA |
输入参数 1 | hdac:DAC 句柄,指向一个 DAC_HandleTypeDef 结构体 |
输入参数 2 | Channel:DAC 通道号,可以是 DAC_CHANNEL_1 或 DAC_CHANNEL_2 |
输入参数 3 | pData:数据缓冲区的指针 |
输入参数 4 | Length:数据缓冲区的长度 |
输入参数 5 | Alignment:数据对齐方式,可以是 DAC_ALIGN_8B_R、DAC_ALIGN_12B_L 或 DAC_ALIGN_12B_R |
输出参数 | 无 |
返回值 | HAL_StatusTypeDef:启动结果,可以是 HAL_OK 或 HAL_ERROR |
先决条件 | 无 |
被调用函数 | 无 |
1.8 HAL_DAC_Stop_DMA
函数名 | HAL_DAC_Stop_DMA |
---|---|
函数原形 | HAL_StatusTypeDef HAL_DAC_Stop_DMA(DAC_HandleTypeDef* hdac, uint32_t Channel) |
功能描述 | 停止 DAC 转换,使用 DMA |
输入参数 1 | hdac:DAC 句柄,指向一个 DAC_HandleTypeDef 结构体 |
输入参数 2 | Channel:DAC 通道号,可以是 DAC_CHANNEL_1 或 DAC_CHANNEL_2 |
输出参数 | 无 |
返回值 | HAL_StatusTypeDef:停止结果,可以是 HAL_OK 或 HAL_ERROR |
先决条件 | 无 |
被调用函数 | 无 |
1.9 HAL_DAC_GetValue
函数名 | HAL_DAC_GetValue |
---|---|
函数原形 | uint32_t HAL_DAC_GetValue(DAC_HandleTypeDef* hdac, uint32_t Channel) |
功能描述 | 获取 DAC 当前输出值 |
输入参数 1 | hdac:DAC 句柄,指向一个 DAC_HandleTypeDef 结构体 |
输入参数 2 |
Channel:DAC 通道号,可以是 DAC_CHANNEL_1 或 DAC_CHANNEL_2 |
| 输出参数 | 无 |
| 返回值 | uint32_t:DAC 当前输出值 |
| 先决条件 | 无 |
| 被调用函数 | 无 |
1.10 HAL_DAC_ConvCpltCallbackCh1
函数名 | HAL_DAC_ConvCpltCallbackCh1 |
---|---|
函数原形 | void HAL_DAC_ConvCpltCallbackCh1(DAC_HandleTypeDef* hdac) |
功能描述 | DAC 通道 1 转换完成回调函数 |
输入参数 | hdac:DAC 句柄,指向一个 DAC_HandleTypeDef 结构体 |
输出参数 | 无 |
返回值 | 无 |
先决条件 | 无 |
被调用函数 | 无 |
1.11 HAL_DAC_ConvHalfCpltCallbackCh1
函数名 | HAL_DAC_ConvHalfCpltCallbackCh1 |
---|---|
函数原形 | void HAL_DAC_ConvHalfCpltCallbackCh1(DAC_HandleTypeDef* hdac) |
功能描述 | DAC 通道 1 半转换完成回调函数 |
输入参数 | hdac:DAC 句柄,指向一个 DAC_HandleTypeDef 结构体 |
输出参数 | 无 |
返回值 | 无 |
先决条件 | 无 |
被调用函数 | 无 |
1.12 HAL_DAC_ErrorCallbackCh1
函数名 | HAL_DAC_ErrorCallbackCh1 |
---|---|
函数原形 | void HAL_DAC_ErrorCallbackCh1(DAC_HandleTypeDef* hdac) |
功能描述 | DAC 通道 1 出错回调函数 |
输入参数 | hdac:DAC 句柄,指向一个 DAC_HandleTypeDef 结构体 |
输出参数 | 无 |
返回值 | 无 |
先决条件 | 无 |
被调用函数 | 无 |
1.13 HAL_DAC_SetValue
函数名 | HAL_DAC_SetValue |
---|---|
函数原形 | HAL_StatusTypeDef HAL_DAC_SetValue(DAC_HandleTypeDef* hdac, uint32_t Channel, uint32_t Alignment, uint32_t Data) |
功能描述 | 设置 DAC 输出值 |
输入参数 1 | hdac:DAC 句柄,指向一个 DAC_HandleTypeDef 结构体 |
输入参数 2 | Channel:DAC 通道号,可以是 DAC_CHANNEL_1 或 DAC_CHANNEL_2 |
输入参数 3 | Alignment:数据对齐方式,可以是 DAC_ALIGN_8B_R、DAC_ALIGN_12B_L 或 DAC_ALIGN_12B_R |
输入参数 4 | Data:要设置的输出值 |
输出参数 | 无 |
返回值 | HAL_StatusTypeDef:设置结果,可以是 HAL_OK 或 HAL_ERROR |
先决条件 | 无 |
被调用函数 | 无 |
1.14 HAL_DAC_ConfigChannel
函数名 | HAL_DAC_ConfigChannel |
---|---|
函数原形 | HAL_StatusTypeDef HAL_DAC_ConfigChannel(DAC_HandleTypeDef* hdac, DAC_ChannelConfTypeDef* sConfig, uint32_t Channel) |
功能描述 | 配置 DAC 通道 |
输入参数 1 | hdac:DAC 句柄,指向一个 DAC_HandleTypeDef 结构体 |
输入参数 2 | sConfig:DAC 通道配置,指向一个 DAC_ChannelConfTypeDef 结构体 |
输入参数 3 | Channel:DAC 通道号,可以是 DAC_CHANNEL_1 或 DAC_CHANNEL_2 |
输出参数 | 无 |
返回值 | HAL_StatusTypeDef:配置结果,可以是 HAL_OK 或 HAL_ERROR |
先决条件 | 无 |
被调用函数 | 无 |
1.15 HAL_DAC_GetState
函数名 | HAL_DAC_GetState |
---|---|
函数原形 | uint32_t HAL_DAC_GetState(DAC_HandleTypeDef* hdac) |
功能描述 | 获取 DAC 当前状态 |
输入参数 | hdac:DAC 句柄,指向一个 DAC_HandleTypeDef 结构体 |
输出参数 | 无 |
返回值 | uint32_t:DAC 当前状态,可能的值有: |
- HAL_DAC_STATE_RESET:复位状态
- HAL_DAC_STATE_READY:就绪状态
- HAL_DAC_STATE_BUSY:忙碌状态
- HAL_DAC_STATE_ERROR:错误状态 |
| 先决条件 | 无 |
| 被调用函数 | 无 |
1.16 HAL_DAC_GetError
函数名 | HAL_DAC_GetError |
---|---|
函数原形 | uint32_t HAL_DAC_GetError(DAC_HandleTypeDef *hdac) |
功能描述 | 获取 DAC 错误状态 |
输入参数 | hdac:DAC 句柄,指向一个 DAC_HandleTypeDef 结构体 |
输出参数 | 无 |
返回值 | uint32_t:DAC 错误状态,可能的值有: |
- HAL_DAC_ERROR_NONE:无错误
- HAL_DAC_ERROR_DMAUNDERRUNCH1:DMA 下溢错误(通道 1)
- HAL_DAC_ERROR_DMAUNDERRUNCH2:DMA 下溢错误(通道 2)
- HAL_DAC_ERROR_DMAUDMAERRCH1:DMA 错误(通道 1)
- HAL_DAC_ERROR_DMAUDMAERRCH2:DMA 错误(通道 2) |
| 先决条件 | 无 |
| 被调用函数 | 无 |
该文档修改记录:
修改时间 | 修改说明 |
---|---|
2024年4月10日 | 第一次发布,介绍了 A9 STM32_HAL库函数 之 DAC通用驱动所有函数的介绍及使用 |
总结
以上就是A9 STM32_HAL库函数 之 DAC通用驱动所有函数的介绍及使用的内容。
有不明白的地方欢迎留言;有建议欢迎留言,我后面编写文档好改进。
创作不容,如果文档对您有帮助,记得给个赞。