|
STM32G474xx HAL 用户手册
|
初始化和配置函数。 更多...
函数 | |
| HAL_StatusTypeDef | HAL_RTC_Init (RTC_HandleTypeDef *hrtc) |
| 初始化 RTC 外设。 | |
| HAL_StatusTypeDef | HAL_RTC_DeInit (RTC_HandleTypeDef *hrtc) |
| 反初始化 RTC 外设。 | |
| HAL_StatusTypeDef | HAL_RTC_RegisterCallback (RTC_HandleTypeDef *hrtc, HAL_RTC_CallbackIDTypeDef CallbackID, pRTC_CallbackTypeDef pCallback) |
| 注册一个用户 RTC 回调,以替代弱预定义回调。 | |
| HAL_StatusTypeDef | HAL_RTC_UnRegisterCallback (RTC_HandleTypeDef *hrtc, HAL_RTC_CallbackIDTypeDef CallbackID) |
| 注销一个 RTC 回调。RTC 回调将重定向到弱预定义回调。 | |
| __weak void | HAL_RTC_MspInit (RTC_HandleTypeDef *hrtc) |
| 初始化 RTC MSP。 | |
| __weak void | HAL_RTC_MspDeInit (RTC_HandleTypeDef *hrtc) |
| 反初始化 RTC MSP。 | |
初始化和配置函数。
===============================================================================
##### 初始化和反初始化函数 #####
===============================================================================
[..] 本节提供允许初始化和配置 RTC 预分频器(同步和异步)、RTC 小时格式、禁用
RTC 寄存器写保护、进入和退出 RTC 初始化模式、RTC 寄存器同步检查以及使能参考时钟检测的函数。
(#) RTC 预分频器被编程为生成 RTC 1Hz 时基。
它被分为两个可编程预分频器以最小化功耗。
(++) 一个 7 位异步预分频器和一个 15 位同步预分频器。
(++) 当同时使用两个预分频器时,建议将异步预分频器配置为较高的值以最小化功耗。
(#) 所有 RTC 寄存器都受写保护。通过向写保护寄存器 RTC_WPR 写入密钥来启用对 RTC 寄存器的写入。
(#) 要配置 RTC 日历,用户应用程序应进入
初始化模式。在此模式下,日历计数器停止
并且可以更新其值。当初始化序列完成时,日历在 4 个 RTCCLK 周期后重新开始计数。
(#) 要在日历初始化后、日历更新后或从低功耗模式唤醒后通过影子寄存器读取日历,
软件必须首先清除 RSF 标志。然后软件必须等待
直到它再次设置后再读取日历,这意味着
日历寄存器已正确复制到
RTC_TR 和 RTC_DR 影子寄存器中。HAL_RTC_WaitForSynchro() 函数
实现了上述软件序列(清除 RSF 和检查 RSF)。
| HAL_StatusTypeDef HAL_RTC_DeInit | ( | RTC_HandleTypeDef * | hrtc | ) |
反初始化 RTC 外设。
| hrtc | RTC 句柄 |
| HAL | 状态 |
定义位于文件 429 行,文件 stm32g4xx_hal_rtc.c。
引用 __HAL_RTC_WRITEPROTECTION_DISABLE, __HAL_RTC_WRITEPROTECTION_ENABLE, HAL_RTC_MspDeInit(), HAL_RTC_STATE_BUSY, HAL_RTC_STATE_ERROR, HAL_RTC_STATE_RESET, HAL_RTC_WaitForSynchro(), __RTC_HandleTypeDef::Instance, __RTC_HandleTypeDef::MspDeInitCallback, RTC_EnterInitMode(), RTC_INT_TAMPER_ALL, 和 __RTC_HandleTypeDef::State。
| HAL_StatusTypeDef HAL_RTC_Init | ( | RTC_HandleTypeDef * | hrtc | ) |
初始化 RTC 外设。
| hrtc | RTC 句柄 |
| HAL | 状态 |
< 旧版弱 InternalTamper3EventCallback
< 旧版弱 InternalTamper4EventCallback
< 旧版弱 InternalTamper5EventCallback
< 旧版弱 InternalTamper6EventCallback
定义位于文件 301 行,文件 stm32g4xx_hal_rtc.c。
引用 __HAL_RTC_IS_CALENDAR_INITIALIZED, __HAL_RTC_WRITEPROTECTION_DISABLE, __HAL_RTC_WRITEPROTECTION_ENABLE, __RTC_HandleTypeDef::AlarmAEventCallback, __RTC_HandleTypeDef::AlarmBEventCallback, assert_param, RTC_InitTypeDef::AsynchPrediv, HAL_RTC_AlarmAEventCallback(), HAL_RTC_MspDeInit(), HAL_RTC_MspInit(), HAL_RTC_STATE_BUSY, HAL_RTC_STATE_READY, HAL_RTC_STATE_RESET, HAL_RTCEx_AlarmBEventCallback(), HAL_RTCEx_InternalTamper3EventCallback(), HAL_RTCEx_InternalTamper4EventCallback(), HAL_RTCEx_InternalTamper5EventCallback(), HAL_RTCEx_InternalTamper6EventCallback(), HAL_RTCEx_Tamper1EventCallback(), HAL_RTCEx_Tamper2EventCallback(), HAL_RTCEx_Tamper3EventCallback(), HAL_RTCEx_TimeStampEventCallback(), HAL_RTCEx_WakeUpTimerEventCallback(), RTC_InitTypeDef::HourFormat, __RTC_HandleTypeDef::Init, __RTC_HandleTypeDef::Instance, __RTC_HandleTypeDef::InternalTamper1EventCallback, __RTC_HandleTypeDef::InternalTamper3EventCallback, __RTC_HandleTypeDef::InternalTamper4EventCallback, __RTC_HandleTypeDef::InternalTamper5EventCallback, __RTC_HandleTypeDef::InternalTamper6EventCallback, IS_RTC_ASYNCH_PREDIV, IS_RTC_HOUR_FORMAT, IS_RTC_OUTPUT, IS_RTC_OUTPUT_POL, IS_RTC_OUTPUT_PULLUP, IS_RTC_OUTPUT_REMAP, IS_RTC_OUTPUT_TYPE, IS_RTC_SYNCH_PREDIV, __RTC_HandleTypeDef::Lock, __RTC_HandleTypeDef::MspDeInitCallback, __RTC_HandleTypeDef::MspInitCallback, RTC_InitTypeDef::OutPut, RTC_InitTypeDef::OutPutPolarity, RTC_InitTypeDef::OutPutPullUp, RTC_InitTypeDef::OutPutRemap, RTC_InitTypeDef::OutPutType, RTC_EnterInitMode(), RTC_ExitInitMode(), __RTC_HandleTypeDef::State, RTC_InitTypeDef::SynchPrediv, __RTC_HandleTypeDef::Tamper1EventCallback, __RTC_HandleTypeDef::Tamper2EventCallback, __RTC_HandleTypeDef::Tamper3EventCallback, __RTC_HandleTypeDef::TimeStampEventCallback, 和 __RTC_HandleTypeDef::WakeUpTimerEventCallback。
| void HAL_RTC_MspDeInit | ( | RTC_HandleTypeDef * | hrtc | ) |
反初始化 RTC MSP。
| hrtc | RTC 句柄 |
| 无 |
定义位于文件 828 行,文件 stm32g4xx_hal_rtc.c。
引用 UNUSED。
被 HAL_RTC_DeInit(), HAL_RTC_Init(), 和 HAL_RTC_UnRegisterCallback() 引用。
| void HAL_RTC_MspInit | ( | RTC_HandleTypeDef * | hrtc | ) |
初始化 RTC MSP。
| hrtc | RTC 句柄 |
| 无 |