单片机与物联网 / 系统课时
RTC 实时时钟
RTC 实时时钟
RTC 的难点不只是“让秒数递增”,而是正确处理低速时钟源、备份域和首次初始化。本课将建立一条稳定启动链路:优先使用外部 32.768 kHz 晶振,利用备份寄存器判断 RTC 是否已配置,并避免普通复位把已保存时间重新清零。
学习目标
- 理解 LSE、LSI、RTC 分频器与备份域之间的关系。
- 设计“首次初始化”和“正常重启”两条不同启动路径。
- 使用备份寄存器保存初始化标记和少量关键状态。
RTC 时钟链路与备份域
RTC 通常位于独立的备份域。主电源断开后,只要 VBAT 仍有电,低速振荡器、RTC 计数器和备份寄存器就可以继续工作。普通系统复位不应清空备份域;只有明确执行备份域复位或备份电源丢失,时间才需要重新设置。
STM32F1 常用的低速时钟源如下:
| 时钟源 | 典型频率 | 优点 | 注意事项 |
|---|---|---|---|
| LSE | 32.768 kHz | 精度高、长期稳定 | 需要外部晶振与正确负载 |
| LSI | 约 40 kHz | 无外部器件、启动简单 | 频率偏差较大,需校准 |
| HSE 分频 | 与主晶振相关 | 可复用外部高速晶振 | 主时钟停振时不可用 |

首次初始化与正常启动
启动代码应先开启电源控制接口并允许访问备份域,再读取备份寄存器中的固定标记。标记存在时,说明 RTC 已完成配置,此时不要复位备份域,也不要重新写默认时间。标记不存在时,才执行低速时钟选择、RTC 初始化、默认时间写入和标记保存。
如果从 LSI 切换到 LSE,通常需要复位备份域,因为 RTC 时钟源选择位受保护。该操作会清除 RTC 和备份寄存器,所以只能在明确的迁移流程中执行,不能放在每次启动的通用初始化路径里。
STM32F1 HAL 配置片段
下面是依赖 STM32CubeF1 HAL 的工程片段。它展示 LSE、RTC 和备份标记的关键顺序,需放入已由 CubeMX 生成启动文件和错误处理函数的工程中。
#include "stm32f1xx_hal.h"
#define RTC_INIT_MARK 0xA55Au
extern RTC_HandleTypeDef hrtc;
static void RTC_BackupDomainInit(void) {
__HAL_RCC_PWR_CLK_ENABLE();
HAL_PWR_EnableBkUpAccess();
hrtc.Instance = RTC;
if (HAL_RTCEx_BKUPRead(&hrtc, RTC_BKP_DR1) == RTC_INIT_MARK) {
return;
}
RCC_OscInitTypeDef osc = {0};
RCC_PeriphCLKInitTypeDef periph = {0};
osc.OscillatorType = RCC_OSCILLATORTYPE_LSE;
osc.LSEState = RCC_LSE_ON;
if (HAL_RCC_OscConfig(&osc) != HAL_OK) {
Error_Handler();
}
periph.PeriphClockSelection = RCC_PERIPHCLK_RTC;
periph.RTCClockSelection = RCC_RTCCLKSOURCE_LSE;
if (HAL_RCCEx_PeriphCLKConfig(&periph) != HAL_OK) {
Error_Handler();
}
__HAL_RCC_RTC_ENABLE();
hrtc.Instance = RTC;
hrtc.Init.AsynchPrediv = RTC_AUTO_1_SECOND;
hrtc.Init.OutPut = RTC_OUTPUTSOURCE_NONE;
if (HAL_RTC_Init(&hrtc) != HAL_OK) {
Error_Handler();
}
RTC_TimeTypeDef time = {0};
time.Hours = 8;
time.Minutes = 0;
time.Seconds = 0;
if (HAL_RTC_SetTime(&hrtc, &time, RTC_FORMAT_BIN) != HAL_OK) {
Error_Handler();
}
HAL_RTCEx_BKUPWrite(&hrtc, RTC_BKP_DR1, RTC_INIT_MARK);
}
static RTC_TimeTypeDef RTC_ReadTime(void) {
RTC_TimeTypeDef time = {0};
if (HAL_RTC_GetTime(&hrtc, &time, RTC_FORMAT_BIN) != HAL_OK) {
Error_Handler();
}
return time;
}生效结果应为:首次上电时等待 LSE 稳定并写入初始化标记;普通复位后检测到标记,跳过时间重设;备份电源丢失后标记消失,系统重新进入首次初始化路径。若项目使用 LSI,应把时钟源替换为 RCC_RTCCLKSOURCE_LSI,并根据实测频率评估每天累计误差。
可运行的启动状态模拟
下面的标准 C 程序不访问硬件,而是模拟备份域是否保留,用于验证启动分支。保存为 rtc_boot_demo.c。
#include <stdbool.h>
#include <stdint.h>
#include <stdio.h>
#define RTC_INIT_MARK 0xA55Au
#define DEFAULT_COUNTER 100000u
typedef struct {
uint16_t marker;
uint32_t counter;
} BackupDomain;
static void boot(BackupDomain *domain, bool backup_lost) {
if (backup_lost) {
domain->marker = 0;
domain->counter = 0;
}
if (domain->marker != RTC_INIT_MARK) {
domain->counter = DEFAULT_COUNTER;
domain->marker = RTC_INIT_MARK;
printf("initialize RTC, counter=%u\n", domain->counter);
} else {
printf("preserve RTC, counter=%u\n", domain->counter);
}
}
int main(void) {
BackupDomain domain = {0};
printf("first boot: ");
boot(&domain, false);
domain.counter += 5;
printf("soft reset: ");
boot(&domain, false);
printf("backup loss: ");
boot(&domain, true);
return 0;
}编译并运行:
gcc -std=c11 -Wall -Wextra -O2 rtc_boot_demo.c -o rtc_boot_demo
./rtc_boot_demo预期输出:
first boot: initialize RTC, counter=100000
soft reset: preserve RTC, counter=100005
backup loss: initialize RTC, counter=100000时间读取与可靠性检查
读取时间后,应检查结果是否处于业务允许范围。例如设备出厂年份之前、远超产品寿命的时间,通常意味着备份域丢失或数据损坏。联网设备可用服务器时间校准,但校准应记录来源和偏差,避免时间突然回退破坏日志顺序。
LSE 启动可能需要较长时间,初始化应设置超时和故障分支。若 LSE 失败,可以进入无 RTC 模式、切换到 LSI 并标记精度降级,或阻止依赖绝对时间的功能。不要在等待晶振时永久阻塞主循环。
Tips 与常见故障
VBAT引脚没有稳定供电时,主电源断开后 RTC 无法保持。- 每次启动都复位备份域,会表现为“RTC 总是回到默认时间”。
- LSI 不是精密时钟,温度和电压变化会造成明显漂移。
- 备份寄存器容量有限,适合保存标记、版本和少量状态,不适合替代参数存储区。
- 修改 RTC 时钟源前先确认是否允许清空现有时间,并为迁移提供用户可见提示。
本课练习
- 在启动状态模拟中增加
clockSource字段,区分 LSE 与 LSI,并在 LSE 失败时自动降级到 LSI。 - 设计一个时间有效性检查函数,要求拒绝早于产品发布日期或晚于指定上限的计数值,并给出恢复策略。
本课总结
- RTC 的可靠性来自独立低速时钟、备份域和
VBAT供电共同作用。 - 初始化标记用于区分首次配置与普通复位,避免无意重设时间。
- LSE 精度更高,LSI 更易部署,但必须接受并管理频率误差。
下一课预告
接下来将继续学习存储、时钟与可靠性设计中的系统级策略,包括掉电检测、看门狗、故障恢复和关键状态持久化。