使用HAL库编写STM32的RTC函数

1设置当前时间：

调用 HAL_RTC_SetTime 来设置小时、分钟、秒和亚秒。
调用 HAL_RTC_SetDate 来设置年、月、日和星期。

HAL_StatusTypeDef HAL_RTC_SetTime(RTC_HandleTypeDef *hrtc, RTC_TimeTypeDef *sTime, uint32_t Format);
HAL_StatusTypeDef HAL_RTC_SetDate(RTC_HandleTypeDef *hrtc, RTC_DateTypeDef *sDate, uint32_t Format);

HAL_RTC_SetTime

这个函数用于设置RTC的时间，包括小时、分钟、秒和亚秒。

HAL_RTC_SetDate

这个函数用于设置RTC的日期，包括年、月、日和星期。

 2获取当前时间：

调用 HAL_RTC_GetTime 来获取当前时间。
调用 HAL_RTC_GetDate 来获取当前日期。
 

HAL_StatusTypeDef HAL_RTC_GetTime(RTC_HandleTypeDef *hrtc, RTC_TimeTypeDef *sTime, uint32_t Format);
HAL_StatusTypeDef HAL_RTC_GetDate(RTC_HandleTypeDef *hrtc, RTC_DateTypeDef *sDate, uint32_t Format);

HAL_RTC_GetTime

这个函数用于获取RTC的当前时间，包括小时、分钟、秒和亚秒。

HAL_RTC_GetDate

这个函数用于获取RTC的当前日期，包括年、月、日和星期。

1. 3配置闹钟：

2. 调用 HAL_RTC_SetAlarm 来设置闹钟A或B的时间。
3. 调用 HAL_RTC_GetAlarm 来获取闹钟的当前设置。

HAL_StatusTypeDef HAL_RTC_SetAlarm(RTC_HandleTypeDef *hrtc, RTC_AlarmTypeDef *sAlarm, uint32_t Format);
HAL_StatusTypeDef HAL_RTC_GetAlarm(RTC_HandleTypeDef *hrtc, RTC_AlarmTypeDef *sAlarm, uint32_t Alarm, uint32_t Format);

HAL_RTC_SetAlarm

这个函数用于设置RTC的闹钟时间。

HAL_RTC_GetAlarm

这个函数用于获取RTC的当前闹钟设置。

闹钟A（Alarm A）

闹钟A是一个功能强大的闹钟，它可以配置为在特定的日期和时间触发，或者忽略日期，仅根据时间触发。它还可以配置为在每周的特定日子触发。闹钟A可以用来实现各种复杂的闹钟功能，比如每天的闹钟、每周特定日子的闹钟或者特定日期的闹钟。

闹钟B（Alarm B）

闹钟B是一个简单的秒闹钟，它可以在设定的秒数后触发。闹钟B通常用于实现周期性的事件，比如每秒、每分钟或每小时触发一次。闹钟B不支持基于日期的触发，它只能根据时间（小时、分钟和秒）来触发。

1. 4处理闹钟中断：

2. 在闹钟中断服务函数中调用 HAL_RTC_AlarmIRQHandler 来处理闹钟中断事件。

1. 5配置唤醒定时器：

2. 调用 HAL_RTCEx_SetWakeUpTimer 来配置唤醒定时器，用于低功耗模式下的定时唤醒。

3. HAL_StatusTypeDef HAL_RTCEx_SetWakeUpTimer(RTC_HandleTypeDef *hrtc, uint32_t WakeUpCounter, uint32_t WakeUpClock);
   

4. hrtc：指向RTC_HandleTypeDef结构体的指针，该结构体包含了RTC模块的配置信息。
5. WakeUpCounter：唤醒定时器的计数值。这个值决定了唤醒定时器在唤醒事件发生之前会等待的时钟周期数。计数值的计算取决于唤醒时钟源的选择。
6. WakeUpClock：唤醒定时器的时钟源。这个参数可以是RTC_WAKEUPCLOCK_RTCCLK_DIV16、RTC_WAKEUPCLOCK_RTCCLK_DIV8、RTC_WAKEUPCLOCK_RTCCLK_DIV4、RTC_WAKEUPCLOCK_RTCCLK_DIV2、RTC_WAKEUPCLOCK_CK_SPRE_16BITS或RTC_WAKEUPCLOCK_CK_SPRE_17BITS，用于选择唤醒定时器的时钟分频。

7. 6处理唤醒定时器中断：

8. 在唤醒定时器中断服务函数中调用 HAL_RTCEx_WakeUpTimerIRQHandler 来处理定时器中断事件。

9. 7防篡改（Tamper）功能：

10. 调用 HAL_RTCEx_SetTamper 来配置防篡改功能。
11. 调用 HAL_RTCEx_TamperGetStatus 来获取防篡改状态。

12. HAL_StatusTypeDef HAL_RTCEx_SetTamper(RTC_HandleTypeDef *hrtc, uint32_t Tamper, uint32_t TamperPinActiveLevel);
    HAL_StatusTypeDef HAL_RTCEx_TamperGetStatus(RTC_HandleTypeDef *hrtc, uint32_t Tamper, uint32_t *TamperStatus);
    

    HAL_RTCEx_SetTamper 

13. hrtc：指向RTC_HandleTypeDef结构体的指针，该结构体包含了RTC模块的配置信息。
14. Tamper：这个参数指定了要配置的防篡改引脚。它可以是RTC_TAMPER_1、RTC_TAMPER_2或RTC_TAMPER_3。
15. TamperPinActiveLevel：这个参数指定了防篡改引脚的激活电平。它可以是RTC_TAMPERPIN_ACTIVE_HIGH（高电平激活）或RTC_TAMPERPIN_ACTIVE_LOW（低电平激活）。

17. HAL_RTCEx_TamperGetStatus

18. hrtc：指向RTC_HandleTypeDef结构体的指针，该结构体包含了RTC模块的配置信息。
19. Tamper：这个参数指定了要查询的防篡改输入。它可以是RTC_TAMPER_1、RTC_TAMPER_2、RTC_TAMPER_3或RTC_TAMPER_ALL。
20. TamperStatus：指向uint32_t类型的指针，用于存储获取的防篡改状态

21. 8备份寄存器操作：//一个节点为 uint32_t最大存储数字ffff  65535

22. 调用 HAL_RTCEx_BKUPWrite 来向备份寄存器写入数据。
23. 调用 HAL_RTCEx_BKUPRead 来从备份寄存器读取数据。

24. HAL_StatusTypeDef HAL_RTCEx_BKUPWrite(RTC_HandleTypeDef *hrtc, uint32_t BackupRegister, uint32_t Data)
    

25. hrtc: 一个指向RTC_HandleTypeDef结构体的指针，该结构体包含了RTC模块的配置和状态信息。
26. BackupRegister: 要写入的备份寄存器的编号。STM32微控制器通常有多个备份寄存器，编号从0开始。
27. Data: 要写入备份寄存器的数据。这个参数的类型通常是uint32_t，即无符号32位整数。

28. uint32_t HAL_RTCEx_BKUPRead(RTC_HandleTypeDef *hrtc, uint32_t BackupRegister)
    

29. hrtc: 同上，指向RTC_HandleTypeDef结构体的指针。
30. BackupRegister: 要读取的备份寄存器的编号。

31. 9校准RTC：

32. 调用 HAL_RTCEx_SetCalibrationOutPut 来配置RTC的校准输出。
33. 调用 HAL_RTCEx_SetCalibration 来设置RTC的校准值。

34. HAL_RTCEx_SetCalibrationOutPut

    HAL_StatusTypeDef HAL_RTCEx_SetCalibrationOutPut(RTC_HandleTypeDef *hrtc, uint32_t CalibOutput, uint32_t CalibOutputPolarity, uint32_t CalibOutputFrequency)
    

35. hrtc: 指向RTC_HandleTypeDef结构体的指针，包含了RTC的配置和状态信息。
36. CalibOutput: 用于启用或禁用RTC校准输出。通常是一个布尔值，例如RTC_CALIBOUTPUT_ENABLE或RTC_CALIBOUTPUT_DISABLE。
37. CalibOutputPolarity: 用于设置校准输出的极性。可以是RTC_CALIBOUTPUT_POLARITY_HIGH或RTC_CALIBOUTPUT_POLARITY_LOW。
38. CalibOutputFrequency: 用于设置校准输出的频率。可以是RTC_CALIBOUTPUT_FREQ_512HZ、RTC_CALIBOUTPUT_FREQ_1HZ等。

39. 这个函数用于配置RTC的校准输出。校准输出是一个可以被用于外部时钟校准的信号。返回值是一个HAL_StatusTypeDef枚举类型的值，指示操作是否成功。

    HAL_RTCEx_SetCalibration

    HAL_StatusTypeDef HAL_RTCEx_SetCalibration(RTC_HandleTypeDef *hrtc, uint32_t CalibSign, uint32_t Value)
    

40. hrtc: 同上，指向RTC_HandleTypeDef结构体的指针。
41. CalibSign: 用于设置校准值的符号。可以是RTC_CALIBSIGN_POSITIVE或RTC_CALIBSIGN_NEGATIVE。
42. Value: 要设置的校准值。这个值决定了校准的幅度。

43. 这个函数用于设置RTC的校准值。RTC校准功能允许微调时钟频率，以补偿晶体的偏差。返回值是一个HAL_StatusTypeDef枚举类型的值，指示操作是否成功。

44. 10时间戳功能：

45. 调用 HAL_RTCEx_SetTimeStamp 来配置时间戳功能。
46. 调用 HAL_RTCEx_GetTimeStamp 来获取时间戳值。

HAL_RTCEx_SetTimeStamp

HAL_StatusTypeDef HAL_RTCEx_SetTimeStamp(RTC_HandleTypeDef *hrtc, uint32_t TimeStampEdge, uint32_t RTC_TimeStampPin)

这个函数用于配置RTC的时间戳功能。时间戳功能允许在指定的引脚上检测到边沿事件时捕获当前时间。返回值是一个HAL_StatusTypeDef枚举类型的值，指示操作是否成功。

HAL_RTCEx_GetTimeStamp

HAL_StatusTypeDef HAL_RTCEx_GetTimeStamp(RTC_HandleTypeDef *hrtc, RTC_TimeTypeDef *sTimeStamp, RTC_DateTypeDef *sTimeStampDate, uint32_t Format)

作者：快秃头的码农