A42 STM32_HAL库函数 之 Rtc扩展驱动 所有函数的介绍及使用
1 该驱动函数预览
序号 | 函数名 | 描述 |
---|
1 | HAL_RTCEx_SetTamper() | 设置RTC的防窃听功能。 |
2 | HAL_RTCEx_SetTamper_IT() | 设置RTC的防窃听功能并启用中断。 |
3 | HAL_RTCEx_DeactivateTamper() | 停用RTC的防窃听功能。 |
4 | HAL_RTCEx_TamperIRQHandler() | RTC防窃听功能中断处理程序。 |
5 | HAL_RTCEx_Tamper1EventCallback() | RTC防窃听功能事件1回调函数。 |
6 | HAL_RTCEx_PollForTamper1Event() | 轮询RTC防窃听功能事件1。 |
7 | HAL_RTCEx_SetSecond_IT() | 设置RTC的秒中断并启用中断。 |
8 | HAL_RTCEx_DeactivateSecond() | 停用RTC的秒中断。 |
9 | HAL_RTCEx_RTCIRQHandler() | RTC中断处理程序。 |
10 | HAL_RTCEx_RTCEventCallback() | RTC事件回调函数。 |
11 | HAL_RTCEx_RTCEventErrorCallback() | RTC事件错误回调函数。 |
12 | HAL_RTCEx_BKUPWrite() | 写入RTC备份寄存器的值。 |
13 | HAL_RTCEx_BKUPRead() | 读取RTC备份寄存器的值。 |
14 | HAL_RTCEx_SetSmoothCalib() | 设置RTC的平滑校准值。 |
以下是使用模板:
#include "stm32f4xx_hal.h"
int main(void) {
HAL_Init();
HAL_RTCEx_SetTamper();
HAL_RTCEx_SetTamper_IT();
HAL_RTCEx_DeactivateTamper();
HAL_RTCEx_SetSecond_IT();
HAL_RTCEx_DeactivateSecond();
HAL_RTCEx_BKUPWrite();
HAL_RTCEx_BKUPRead();
return 0;
}
1.1 HAL_RTCEx_SetTamper
函数名 | HAL_RTCEx_SetTamper |
---|
函数原形 | HAL_StatusTypeDef HAL_RTCEx_SetTamper(RTC_HandleTypeDef *hrtc, RTC_TamperTypeDef *sTamper) |
功能描述 | 配置RTC防篡改功能 |
输入参数 1 | hrtc:RTC句柄结构体指针 |
输入参数 2 | sTamper:RTC防篡改配置结构体指针 |
输出参数 | 无 |
返回值 | HAL_StatusTypeDef:函数执行状态 |
先决条件 | 无 |
被调用函数 | 无 |
1.2 HAL_RTCEx_SetTamper_IT
函数名 | HAL_RTCEx_SetTamper_IT |
---|
函数原形 | HAL_StatusTypeDef HAL_RTCEx_SetTamper_IT(RTC_HandleTypeDef *hrtc, RTC_TamperTypeDef *sTamper) |
功能描述 | 配置RTC防篡改功能并使能中断 |
输入参数 1 | hrtc:RTC句柄结构体指针 |
输入参数 2 | sTamper:RTC防篡改配置结构体指针 |
输出参数 | 无 |
返回值 | HAL_StatusTypeDef:函数执行状态 |
先决条件 | 无 |
被调用函数 | 无 |
1.3 HAL_RTCEx_DeactivateTamper
函数名 | HAL_RTCEx_DeactivateTamper |
---|
函数原形 | HAL_StatusTypeDef HAL_RTCEx_DeactivateTamper(RTC_HandleTypeDef *hrtc, uint32_t Tamper) |
功能描述 | 关闭RTC防篡改功能 |
输入参数 1 | hrtc:RTC句柄结构体指针 |
输入参数 2 | Tamper:防篡改编号 |
输出参数 | 无 |
返回值 | HAL_StatusTypeDef:函数执行状态 |
先决条件 | 无 |
被调用函数 | 无 |
1.4 HAL_RTCEx_TamperIRQHandler
函数名 | HAL_RTCEx_TamperIRQHandler |
---|
函数原形 | void HAL_RTCEx_TamperIRQHandler(RTC_HandleTypeDef *hrtc) |
功能描述 | RTC防篡改中断服务程序 |
输入参数 | hrtc:RTC句柄结构体指针 |
输出参数 | 无 |
返回值 | 无 |
先决条件 | 无 |
被调用函数 | 无 |
1.5 HAL_RTCEx_Tamper1EventCallback
函数名 | HAL_RTCEx_Tamper1EventCallback |
---|
函数原形 | void HAL_RTCEx_Tamper1EventCallback(RTC_HandleTypeDef *hrtc) |
功能描述 | RTC防篡改事件回调函数 |
输入参数 | hrtc:RTC句柄结构体指针 |
输出参数 | 无 |
返回值 | 无 |
先决条件 | 无 |
被调用函数 | 无 |
1.6 HAL_RTCEx_PollForTamper1Event
函数名 | HAL_RTCEx_PollForTamper1Event |
---|
函数原形 | HAL_StatusTypeDef HAL_RTCEx_PollForTamper1Event(RTC_HandleTypeDef *hrtc, uint32_t Timeout) |
功能描述 | 轮询RTC防篡改事件 |
输入参数 1 | hrtc:RTC句柄结构体指针 |
输入参数 2 | Timeout:超时时间(毫秒) |
输出参数 | 无 |
返回值 | HAL_StatusTypeDef:函数执行状态 |
先决条件 | 无 |
被调用函数 | 无 |
1.7 HAL_RTCEx_SetSecond_IT
函数名 | HAL_RTCEx_SetSecond_IT |
---|
函数原形 | HAL_StatusTypeDef HAL_RTCEx_SetSecond_IT(RTC_HandleTypeDef *hrtc) |
功能描述 | 设置RTC秒中断使能 |
输入参数 | hrtc:RTC句柄结构体指针 |
输出参数 | 无 |
返回值 | HAL_StatusTypeDef:函数执行状态 |
先决条件 | 无 |
被调用函数 | 无 |
1.8 HAL_RTCEx_DeactivateSecond
函数名 | HAL_RTCEx_DeactivateSecond |
---|
函数原形 | HAL_StatusTypeDef HAL_RTCEx_DeactivateSecond(RTC_HandleTypeDef *hrtc) |
功能描述 | 关闭RTC秒中断使能 |
输入参数 | hrtc:RTC句柄结构体指针 |
输出参数 | 无 |
返回值 | HAL_StatusTypeDef:函数执行状态 |
先决条件 | 无 |
被调用函数 | 无 |
1.9 HAL_RTCEx_RTCIRQHandler
函数名 | HAL_RTCEx_RTCIRQHandler |
---|
函数原形 | void HAL_RTCEx_RTCIRQHandler(RTC_HandleTypeDef *hrtc) |
功能描述 | RTC中断服务程序 |
输入参数 | hrtc:RTC句柄结构体指针 |
输出参数 | 无 |
返回值 | 无 |
先决条件 | 无 |
被调用函数 | 无 |
1.10 HAL_RTCEx_RTCEventCallback
函数名 | HAL_RTCEx_RTCEventCallback |
---|
函数原形 | void HAL_RTCEx_RTCEventCallback(RTC_HandleTypeDef *hrtc) |
功能描述 | RTC事件回调函数 |
输入参数 | hrtc:RTC句柄结构体指针 |
输出参数 | 无 |
返回值 | 无 |
先决条件 | 无 |
被调用函数 | 无 |
1.11 HAL_RTCEx_RTCEventErrorCallback
函数名 | HAL_RTCEx_RTCEventErrorCallback |
---|
函数原形 | void HAL_RTCEx_RTCEventErrorCallback(RTC_HandleTypeDef *hrtc) |
功能描述 | RTC事件错误回调函数 |
输入参数 | hrtc:RTC句柄结构体指针 |
输出参数 | 无 |
返回值 | 无 |
先决条件 | 无 |
被调用函数 | 无 |
1.12 HAL_RTCEx_BKUPWrite
函数名 | HAL_RTCEx_BKUPWrite |
---|
函数原形 | HAL_StatusTypeDef HAL_RTCEx_BKUPWrite(RTC_HandleTypeDef *hrtc, uint32_t BackupRegister, uint32_t Data) |
功能描述 | 写入RTC备份寄存器 |
输入参数 1 | hrtc:RTC句柄结构体指针 |
输入参数 2 | BackupRegister:备份寄存器编号 |
输入参数 3 | Data:写入数据 |
输出参数 | 无 |
返回值 | HAL_StatusTypeDef:函数执行状态 |
先决条件 | 无 |
被调用函数 | 无 |
1.13 HAL_RTCEx_BKUPRead
函数名 | HAL_RTCEx_BKUPRead |
---|
函数原形 | uint32_t HAL_RTCEx_BKUPRead(RTC_HandleTypeDef *hrtc, uint32_t BackupRegister) |
功能描述 | 读取RTC备份寄存器 |
输入参数 1 | hrtc:RTC句柄结构体指针 |
输入参数 2 | BackupRegister:备份寄存器编号 |
输出参数 | 无 |
返回值 | uint32_t:读取的数据 |
先决条件 | 无 |
被调用函数 | 无 |
1.14 HAL_RTCEx_SetSmoothCalib
函数名 | HAL_RTCEx_SetSmoothCalib |
---|
函数原形 | HAL_StatusTypeDef HAL_RTCEx_SetSmoothCalib(RTC_HandleTypeDef *hrtc, uint32_t SmoothCalibPeriod, uint32_t SmoothCalibPlusPulses, uint32_t SmouthCalibMinusPulsesValue) |
功能描述 | 设置RTC平滑校准 |
输入参数 1 | hrtc:RTC句柄结构体指针 |
输入参数 2 | SmoothCalibPeriod:平滑校准周期 |
输入参数 3 | SmoothCalibPlusPulses:平滑校准加脉冲数 |
输入参数 4 | SmoothCalibMinusPulsesValue:平滑校准减脉冲值 |
输出参数 | 无 |
返回值 | HAL_StatusTypeDef:函数执行状态 |
先决条件 | 无 |
被调用函数 | 无 |
该文档修改记录:
修改时间 | 修改说明 |
---|
2024年4月30日 | 第一次发布,介绍了该博客驱动所有函数的介绍及使用 |
总结
以上就是该博客驱动所有函数的介绍及使用的内容。
有不明白的地方欢迎留言;有建议欢迎留言,我后面编写文档好改进。
创作不容,如果文档对您有帮助,记得给个赞。