A6 STM32_HAL库函数 之 Cec通用驱动程序所有函数的介绍及使用
- [1 通用定时器(TIM)预览](#1 通用定时器(TIM)预览)
-
- [1.1 HAL_CEC_Init](#1.1 HAL_CEC_Init)
- [1.2 HAL_CEC_DeInit](#1.2 HAL_CEC_DeInit)
- [1.3 HAL_CEC_SetDeviceAddress](#1.3 HAL_CEC_SetDeviceAddress)
- [1.4 HAL_CEC_MspInit](#1.4 HAL_CEC_MspInit)
- [1.5 HAL_CEC_MspDeInit](#1.5 HAL_CEC_MspDeInit)
- [1.6 HAL_CEC_Transmit_IT](#1.6 HAL_CEC_Transmit_IT)
- [1.7 HAL_CEC_GetLastReceivedFrameSize](#1.7 HAL_CEC_GetLastReceivedFrameSize)
- [1.8 HAL_CEC_ChangeRxBuffer](#1.8 HAL_CEC_ChangeRxBuffer)
- [1.9 HAL_CEC_IRQHandler](#1.9 HAL_CEC_IRQHandler)
- [1.10 HAL_CEC_TxCpltCallback](#1.10 HAL_CEC_TxCpltCallback)
- [1.11 HAL_CEC_RxCpltCallback](#1.11 HAL_CEC_RxCpltCallback)
- [1.12 HAL_CEC_ErrorCallback](#1.12 HAL_CEC_ErrorCallback)
- [1.13 HAL_CEC_GetState](#1.13 HAL_CEC_GetState)
- [1.14 HAL_CEC_GetError](#1.14 HAL_CEC_GetError)
- 该文档修改记录:
- 总结
1 通用定时器(TIM)预览
序号 | 函数名 | 描述 |
---|---|---|
1 | HAL_CEC_Init() | 初始化CEC外设。 |
2 | HAL_CEC_DeInit() | 反初始化CEC外设。 |
3 | HAL_CEC_SetDeviceAddress() | 设置CEC设备地址。 |
4 | HAL_CEC_MspInit() | 初始化MCU外设相关的CEC引脚或资源。 |
5 | HAL_CEC_MspDeInit() | 反初始化MCU外设相关的CEC引脚或资源。 |
6 | HAL_CEC_Transmit_IT() | 异步发送CEC消息,使用中断处理发送完成。 |
7 | HAL_CEC_GetLastReceivedFrameSize() | 获取最后接收到的CEC帧大小。 |
8 | HAL_CEC_ChangeRxBuffer() | 更改CEC接收缓冲区。 |
9 | HAL_CEC_IRQHandler() | CEC中断处理程序。 |
10 | HAL_CEC_TxCpltCallback() | CEC发送完成回调函数。 |
11 | HAL_CEC_RxCpltCallback() | CEC接收完成回调函数。 |
12 | HAL_CEC_ErrorCallback() | CEC错误回调函数。 |
13 | HAL_CEC_GetState() | 获取CEC状态。 |
14 | HAL_CEC_GetError() | 获取CEC错误状态。 |
使用模板:
c
#include "stm32f4xx_hal.h"
int main(void) {
// HAL初始化
HAL_Init();
// 初始化MCU外设相关的引脚或资源
HAL_MspInit();
// 初始化CEC外设
HAL_CEC_Init();
// 设置CEC设备地址
HAL_CEC_SetDeviceAddress();
// 启动CEC中断
// 进行其他操作...
// 异步发送CEC消息
HAL_CEC_Transmit_IT();
// 获取最后接收到的CEC帧大小
uint32_t lastFrameSize = HAL_CEC_GetLastReceivedFrameSize();
// 更改CEC接收缓冲区
HAL_CEC_ChangeRxBuffer();
// 获取CEC状态
uint32_t cecState = HAL_CEC_GetState();
// 获取CEC错误状态
uint32_t cecError = HAL_CEC_GetError();
// 反初始化CEC外设
HAL_CEC_DeInit();
// 反初始化MCU外设相关的引脚或资源
HAL_MspDeInit();
return 0;
}
1.1 HAL_CEC_Init
函数名 | HAL_CEC_Init |
---|---|
函数原形 | HAL_StatusTypeDef HAL_CEC_Init(CEC_HandleTypeDef *hcec) |
功能描述 | 初始化 CEC 控制器 |
输入参数 | hcec:CEC 句柄,指向一个 CEC_HandleTypeDef 结构体 |
输出参数 | 无 |
返回值 | HAL_StatusTypeDef:初始化结果,可以是 HAL_OK 或 HAL_ERROR |
先决条件 | 无 |
被调用函数 | 无 |
1.2 HAL_CEC_DeInit
函数名 | HAL_CEC_DeInit |
---|---|
函数原形 | HAL_StatusTypeDef HAL_CEC_DeInit(CEC_HandleTypeDef *hcec) |
功能描述 | 反初始化 CEC 控制器 |
输入参数 | hcec:CEC 句柄,指向一个 CEC_HandleTypeDef 结构体 |
输出参数 | 无 |
返回值 | HAL_StatusTypeDef:反初始化结果,可以是 HAL_OK 或 HAL_ERROR |
先决条件 | 无 |
被调用函数 | 无 |
1.3 HAL_CEC_SetDeviceAddress
函数名 | HAL_CEC_SetDeviceAddress |
---|---|
函数原形 | HAL_StatusTypeDef HAL_CEC_SetDeviceAddress(CEC_HandleTypeDef *hcec, uint16_t CEC_OwnAddress) |
功能描述 | 设置 CEC 设备地址 |
输入参数 1 | hcec:CEC 句柄,指向一个 CEC_HandleTypeDef 结构体 |
输入参数 2 | CEC_OwnAddress:CEC 设备地址 |
输出参数 | 无 |
返回值 | HAL_StatusTypeDef:操作结果,可以是 HAL_OK 或 HAL_ERROR |
先决条件 | 无 |
被调用函数 | 无 |
1.4 HAL_CEC_MspInit
函数名 | HAL_CEC_MspInit |
---|---|
函数原形 | void HAL_CEC_MspInit(CEC_HandleTypeDef *hcec) |
功能描述 | CEC 外设底层初始化,典型的用途是配置外设的时钟和引脚 |
输入参数 | hcec:CEC 句柄,指向一个 CEC_HandleTypeDef 结构体 |
输出参数 | 无 |
返回值 | 无 |
先决条件 | 无 |
被调用函数 | 无 |
1.5 HAL_CEC_MspDeInit
函数名 | HAL_CEC_MspDeInit |
---|---|
函数原形 | void HAL_CEC_MspDeInit(CEC_HandleTypeDef *hcec) |
功能描述 | CEC 外设底层反初始化,典型的用途是恢复外设的默认配置 |
输入参数 | hcec:CEC 句柄,指向一个 CEC_HandleTypeDef 结构体 |
输出参数 | 无 |
返回值 | 无 |
先决条件 | 无 |
被调用函数 | 无 |
1.6 HAL_CEC_Transmit_IT
函数名 | HAL_CEC_Transmit_IT |
---|---|
函数原形 | HAL_StatusTypeDef HAL_CEC_Transmit_IT(CEC_HandleTypeDef *hcec, uint8_t DestinationAddress, uint8_t *pData, uint32_t Size) |
功能描述 | 以中断方式发送 CEC 数据 |
输入参数 1 | hcec:CEC 句柄,指向一个 CEC_HandleTypeDef 结构体 |
输入参数 2 | DestinationAddress:目标设备地址 |
输入参数 3 | pData:发送数据的指针 |
输入参数 4 | Size:发送数据的大小 |
输出参数 | 无 |
返回值 | HAL_StatusTypeDef:发送结果,可以是 HAL_OK 或 HAL_ERROR |
先决条件 | 无 |
被调用函数 | 无 |
1.7 HAL_CEC_GetLastReceivedFrameSize
函数名 | HAL_CEC_GetLastReceivedFrameSize |
---|---|
函数原形 | uint32_t HAL_CEC_GetLastReceivedFrameSize(CEC_HandleTypeDef *hcec) |
功能描述 | 获取最后接收到的 CEC 帧的大小 |
输入参数 | hcec:CEC 句柄,指向一个 CEC_HandleTypeDef 结构体 |
输出参数 | 无 |
返回值 | uint32_t:最后接收到的 CEC 帧的大小 |
先决条件 | 无 |
被调用函数 | 无 |
1.8 HAL_CEC_ChangeRxBuffer
函数名 | HAL_CEC_ChangeRxBuffer |
---|---|
函数原形 | HAL_StatusTypeDef HAL_CEC_ChangeRxBuffer(CEC_HandleTypeDef *hcec, uint8_t *RxBuffer) |
功能描述 | 更改 CEC 接收缓冲区 |
输入参数 1 | hcec:CEC 句柄,指向一个 CEC_HandleTypeDef 结构体 |
输入参数 2 | RxBuffer:新的接收缓冲区指针 |
输出参数 | 无 |
返回值 | HAL_StatusTypeDef:操作结果,可以是 HAL_OK 或 HAL_ERROR |
先决条件 | 无 |
被调用函数 | 无 |
1.9 HAL_CEC_IRQHandler
函数名 | HAL_CEC_IRQHandler |
---|---|
函数原形 | void HAL_CEC_IRQHandler(CEC_HandleTypeDef *hcec) |
功能描述 | CEC 中断处理函数 |
输入参数 | hcec:CEC 句柄,指向一个 CEC_HandleTypeDef 结构体 |
输出参数 | 无 |
返回值 | 无 |
先决条件 | 无 |
被调用函数 |
| 无 |
1.10 HAL_CEC_TxCpltCallback
函数名 | HAL_CEC_TxCpltCallback |
---|---|
函数原形 | void HAL_CEC_TxCpltCallback(CEC_HandleTypeDef *hcec) |
功能描述 | CEC 数据传输完成回调函数 |
输入参数 | hcec:CEC 句柄,指向一个 CEC_HandleTypeDef 结构体 |
输出参数 | 无 |
返回值 | 无 |
先决条件 | 无 |
被调用函数 | 无 |
1.11 HAL_CEC_RxCpltCallback
函数名 | HAL_CEC_RxCpltCallback |
---|---|
函数原形 | void HAL_CEC_RxCpltCallback(CEC_HandleTypeDef *hcec) |
功能描述 | CEC 数据接收完成回调函数 |
输入参数 | hcec:CEC 句柄,指向一个 CEC_HandleTypeDef 结构体 |
输出参数 | 无 |
返回值 | 无 |
先决条件 | 无 |
被调用函数 | 无 |
1.12 HAL_CEC_ErrorCallback
函数名 | HAL_CEC_ErrorCallback |
---|---|
函数原形 | void HAL_CEC_ErrorCallback(CEC_HandleTypeDef *hcec) |
功能描述 | CEC 错误处理回调函数 |
输入参数 | hcec:CEC 句柄,指向一个 CEC_HandleTypeDef 结构体 |
输出参数 | 无 |
返回值 | 无 |
先决条件 | 无 |
被调用函数 | 无 |
1.13 HAL_CEC_GetState
函数名 | HAL_CEC_GetState |
---|---|
函数原形 | uint32_t HAL_CEC_GetState(CEC_HandleTypeDef *hcec) |
功能描述 | 获取 CEC 控制器状态 |
输入参数 | hcec:CEC 句柄,指向一个 CEC_HandleTypeDef 结构体 |
输出参数 | 无 |
返回值 | uint32_t:CEC 控制器状态,可能的值有: |
- HAL_CEC_STATE_RESET:复位状态
- HAL_CEC_STATE_READY:就绪状态
- HAL_CEC_STATE_BUSY:忙碌状态
- HAL_CEC_STATE_BUSY_TX:忙碌发送状态
- HAL_CEC_STATE_BUSY_RX:忙碌接收状态
- HAL_CEC_STATE_ERROR:错误状态
- HAL_CEC_STATE_BUSY_TX_RX:忙碌发送接收状态 |
| 先决条件 | 无 |
| 被调用函数 | 无 |
1.14 HAL_CEC_GetError
函数名 | HAL_CEC_GetError |
---|---|
函数原形 | uint32_t HAL_CEC_GetError(CEC_HandleTypeDef *hcec) |
功能描述 | 获取 CEC 错误状态 |
输入参数 | hcec:CEC 句柄,指向一个 CEC_HandleTypeDef 结构体 |
输出参数 | 无 |
返回值 | uint32_t:CEC 错误状态,可能的值有: |
- HAL_CEC_ERROR_NONE:无错误
- HAL_CEC_ERROR_BRE:比特率错误
- HAL_CEC_ERROR_SBPE:起始比特错误
- HAL_CEC_ERROR_ACKE:确认错误
- HAL_CEC_ERROR_LINE:线路错误 |
| 先决条件 | 无 |
| 被调用函数 | 无 |
该文档修改记录:
修改时间 | 修改说明 |
---|---|
2024年4月9日 | 第一次发布,介绍了 A6 STM32_HAL库函数 之 Cec通用驱动程序所有函数的介绍及使用 |
总结
以上就是A6 STM32_HAL库函数 之 Cec通用驱动程序所有函数的介绍及使用的内容。
有不明白的地方欢迎留言;有建议欢迎留言,我后面编写文档好改进。
创作不容,如果文档对您有帮助,记得给个赞。