STM32 RTC实时时钟详解与HAL库实战教程

摘要：本文深入讲解STM32的RTC（Real-Time Clock）模块，涵盖原理分析、CubeMX配置、HAL库编程实现，并提供完整的闹钟设置与时间校准例程代码。通过本文，您将掌握RTC在低功耗场景下的核心应用技巧。

1. RTC模块概述

RTC（实时时钟）是STM32内部独立运行的定时器模块，主要特点：

独立供电：通过VBAT引脚连接备用电池（3V纽扣电池）
32位计数器：可记录秒级时间（配合预分频器）
闹钟中断：支持多种唤醒事件
日历功能：自动处理月、年、闰年计算
低功耗：在待机模式下仍可运行

2. 硬件设计要点

2.1 硬件连接

VBAT引脚：连接3V纽扣电池（CR2032）
32.768kHz晶振：建议外接低速晶振（LSE）

备用电源电路：

VDD -> 3.3V主电源
VBAT -> 电池正极
GND -> 共地

3. CubeMX配置步骤

3.1 时钟配置

激活RTC时钟源：LSE（外部低速晶振）
启用日历功能
配置预分频器：
- Asynchronous Prescaler: 127
- Synchronous Prescaler: 255
  （得到1Hz时钟：(32768/(127+1)*(255+1)) = 1Hz）

3.2 NVIC设置

使能RTC全局中断
使能闹钟中断（Alarm A）

4. HAL库代码实现

4.1 RTC初始化

void MX_RTC_Init(void)
{RTC_TimeTypeDef sTime = {0};RTC_DateTypeDef sDate = {0};hrtc.Instance = RTC;hrtc.Init.HourFormat = RTC_HOURFORMAT_24;hrtc.Init.AsynchPrediv = 127;hrtc.Init.SynchPrediv = 255;hrtc.Init.OutPut = RTC_OUTPUT_DISABLE;hrtc.Init.OutPutPolar = RTC_OUTPUT_POLARITY_HIGH;HAL_RTC_Init(&hrtc);// 设置初始时间sTime.Hours = 12;sTime.Minutes = 0;sTime.Seconds = 0;HAL_RTC_SetTime(&hrtc, &sTime, RTC_FORMAT_BIN);// 设置初始日期sDate.WeekDay = RTC_WEEKDAY_MONDAY;sDate.Month = RTC_MONTH_JANUARY;sDate.Date = 1;sDate.Year = 24; // 2024年HAL_RTC_SetDate(&hrtc, &sDate, RTC_FORMAT_BIN);
}

4.2 读取当前时间

void Get_TimeDate(RTC_TimeTypeDef *sTime, RTC_DateTypeDef *sDate)
{HAL_RTC_GetTime(&hrtc, sTime, RTC_FORMAT_BIN);HAL_RTC_GetDate(&hrtc, sDate, RTC_FORMAT_BIN);
}

4.3 设置闹钟（30秒后触发）

void Set_Alarm(void)
{RTC_AlarmTypeDef sAlarm = {0};sAlarm.AlarmTime.Hours = 0;sAlarm.AlarmTime.Minutes = 0;sAlarm.AlarmTime.Seconds = 30; // 30秒后触发sAlarm.AlarmMask = RTC_ALARMMASK_NONE;sAlarm.AlarmSubSecondMask = RTC_ALARMSUBSECONDMASK_NONE;sAlarm.Alarm = RTC_ALARM_A;HAL_RTC_SetAlarm_IT(&hrtc, &sAlarm, RTC_FORMAT_BIN);
}

4.4 中断回调函数

void HAL_RTC_AlarmAEventCallback(RTC_HandleTypeDef *hrtc)
{HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin); // 翻转LEDSet_Alarm(); // 重新设置下一次闹钟
}

5. 关键API说明

函数	功能描述
HAL_RTC_SetTime()	设置RTC当前时间
HAL_RTC_GetTime()	读取当前时间
HAL_RTC_SetAlarm_IT()	设置带中断的闹钟
HAL_RTCEx_SetWakeUpTimer()	配置唤醒定时器