单片机与物联网 / 系统课时

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 已完成配置,此时不要复位备份域,也不要重新写默认时间。标记不存在时,才执行低速时钟选择、RTC 初始化、默认时间写入和标记保存。

如果从 LSI 切换到 LSE,通常需要复位备份域,因为 RTC 时钟源选择位受保护。该操作会清除 RTC 和备份寄存器,所以只能在明确的迁移流程中执行,不能放在每次启动的通用初始化路径里。

STM32F1 HAL 配置片段

下面是依赖 STM32CubeF1 HAL 的工程片段。它展示 LSE、RTC 和备份标记的关键顺序,需放入已由 CubeMX 生成启动文件和错误处理函数的工程中。

c
#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。

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;
}

编译并运行:

bash
gcc -std=c11 -Wall -Wextra -O2 rtc_boot_demo.c -o rtc_boot_demo
./rtc_boot_demo

预期输出:

text
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 时钟源前先确认是否允许清空现有时间,并为迁移提供用户可见提示。

本课练习

  1. 在启动状态模拟中增加 clockSource 字段,区分 LSE 与 LSI,并在 LSE 失败时自动降级到 LSI。
  2. 设计一个时间有效性检查函数,要求拒绝早于产品发布日期或晚于指定上限的计数值,并给出恢复策略。

本课总结

  • RTC 的可靠性来自独立低速时钟、备份域和 VBAT 供电共同作用。
  • 初始化标记用于区分首次配置与普通复位,避免无意重设时间。
  • LSE 精度更高,LSI 更易部署,但必须接受并管理频率误差。

下一课预告

接下来将继续学习存储、时钟与可靠性设计中的系统级策略,包括掉电检测、看门狗、故障恢复和关键状态持久化。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

RTC 实时时钟

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通