简介：面向嵌入式驱动开发者的RTC（实时时钟）驱动开发参考包，围绕实时时钟芯片的驱动实现展开，覆盖初始化、时间读取与设置、中断处理、电源管理、闰年与月份天数更新等关键环节，适合需要基于嵌入式平台实现或调试RTC驱动的工程师参考学习。资源共8个文件，包含C语言驱动源码与测试程序、对应头文件、Makefile构建脚本、使用说明文档，以及两张RTC晶体校正参数生成表（xlsm），可用于计算不同温度下的晶振频偏校正参数，帮助读者从底层寄存器配置到上层接口调用完整掌握驱动逻辑。压缩包整体约244KB，结构精简，便于按需查阅。目前已有93人学习，对于有一定驱动开发基础、希望缩短RTC模块开发或调优时钟精度的开发者，具有直接的工程参考价值。
1. rtc.rar_RTC 是什么：一个 RTC 归档包能帮你省掉哪些事
打开 rtc.rar_RTC 之前，先想清楚你在找什么东西。这个压缩包名字里的 RTC 不是网络实时通信，而是实时时钟（Real-Time Clock）：系统断电之后、主 CPU 都停了，它靠一颗纽扣电池和 32.768kHz 晶振继续走时。解压出来的东西通常是一套驱动源码加硬件接线说明，解决的就是三件事：上电能读到正确时间、掉电后时间不丢、到点能定时唤醒设备。适合做表计、数据记录仪、低功耗传感器的嵌入式工程师。如果你正被「时间一掉电就归零」「RTC 初始化卡死」这类问题折磨，这篇笔记就是按这个标题的落地路径写的。
2. 拆包与跑通最小工程：RTC 初始化到串口每秒打印时间
2.1 先看包里有什么：驱动、板级配置、硬件说明
类似 rtc.rar_RTC 这类归档包里，文件命名风格五花八门，但结构上大差不差，常见是三层：
| 文件类型 | 典型命名 | 干什么用 |
|---|---|---|
| RTC 驱动 | rtc_drv.c / hal_rtc.c | 寄存器读写、预分频配置、闹钟/唤醒中断封装 |
| 应用层 | rtc_app.c / time_mgr.c | 时间格式转换、闹钟回调、备份寄存器管理 |
| 板级配置 | board_rtc.c / bsp_rtc.c | 引脚、晶振负载电容、VBAT 供电链路初始化 |
如果你拿到的包里只有单个 .c 文件，也别急着失望，说明作者把驱动和应用揉在了一起。先用文本搜索找三个关键字：LSE、AsynchPrediv、VBAT。搜得到，说明这套代码是正经走外部晶振方案；搜不到 LSE，基本可以判定走的是 LSI 内部 RC，掉电保时的能力会打折扣，后面我会专门讲这个区别。
2.2 时钟源为什么必须选 LSE：LSI 与 LSE 的差别
RTC 的时钟源有两个选项，这里直接给结论：要做掉电走时，必须选 LSE 外部 32.768kHz 晶振。
| 项目 | LSE 外部晶振 | LSI 内部 RC |
|---|---|---|
| 频率 | 32.768 kHz | 约 32 kHz |
| 精度 | 20 ppm 以内（取决于晶振） | 1%~5% 温漂 |
| 掉电后是否继续走 | 是，由 VBAT 域供电 | 否，主电源掉电即停 |
| 成本 | 多一颗晶振和两颗电容 | 零成本 |
我之前见过一个项目，为了省晶振用了 LSI，常温下走时还能忍，一到冬天户外设备一天能偏几分钟，最后全部返工换 LSE。所以如果你在 rtc.rar_RTC 里看到RCC_RTCCLKSource_LSI，这段代码最多只能用来熟悉流程，不能直接上产品。
2.3 初始化流程：从解锁备份域到 RTC 输出 1Hz
下面是基于 STM32 HAL 的 RTC 初始化最小代码，市面上大多数 Cortex-M RTC 驱动都是这个套路：
void MX_RTC_Init(void) { RTC_TimeTypeDef sTime = {0}; RTC_DateTypeDef sDate = {0}; // 1. 开启 LSE 外部晶振并等待起振 RCC_OscInitTypeDef RCC_OscInitStruct = {0}; RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_LSE; RCC_OscInitStruct.LSEState = RCC_LSE_ON; RCC_OscInitStruct.PLL.PLLState = RCC_PLL_NONE; if (HAL_RCC_OscConfig(&RCC_OscInitStruct) != HAL_OK) { Error_Handler(); } // 2. 把 RTC 时钟源接到 LSE 上 RCC_PeriphCLKInitTypeDef PeriphClkInit = {0}; PeriphClkInit.PeriphClockSelection = RCC_PERIPHCLK_RTC; PeriphClkInit.RTCClockSelection = RCC_RTCCLKSOURCE_LSE; if (HAL_RCCEx_PeriphCLKConfig(&PeriphClkInit) != HAL_OK) { Error_Handler(); } __HAL_RCC_RTC_ENABLE(); // 3. 配置 RTC 预分频，把 32768 Hz 分频到 1 Hz hrtc.Instance = RTC; hrtc.Init.HourFormat = RTC_HOURFORMAT_24HOUR; hrtc.Init.AsynchPrediv = 127; hrtc.Init.SynchPrediv = 255; hrtc.Init.OutPut = RTC_OUTPUT_DISABLE; if (HAL_RTC_Init(&hrtc) != HAL_OK) { Error_Handler(); } // 4. 设置初始日期和时间 sDate.Year = 24; sDate.Month = 1; sDate.Date = 1; sDate.WeekDay = 1; HAL_RTC_SetDate(&hrtc, &sDate, RTC_FORMAT_BIN); sTime.Hours = 0; sTime.Minutes = 0; sTime.Seconds = 0; HAL_RTC_SetTime(&hrtc, &sTime, RTC_FORMAT_BIN); }这里有两个参数是 RTC 能否走到 1Hz 的关键：AsynchPrediv和SynchPrediv。LSE 时钟 32768 Hz 先经过异步预分频除以 128，再经过同步预分频除以 256，32768 / 128 / 256 = 1 Hz。所以 127 和 255 不是随便填的，如果改成 127 和 127，RTC 秒计数会比真实时间快一倍。常见的其他组合有同步 32767、异步 0，同样能得到 1Hz，但异步分频为 0 会增加功耗，不推荐在低功耗场景用。
2.4 读回时间并打印：验证 RTC 真的在走
初始化之后，在主循环里每秒读一次时间打印到串口：
RTC_TimeTypeDef now = {0}; while (1) { // 必须先读时间，再读日期，否则日期会锁住时间寄存器 HAL_RTC_GetTime(&hrtc, &now, RTC_FORMAT_BIN); printf("%02d:%02d:%02d\r\n", now.Hours, now.Minutes, now.Seconds); HAL_Delay(1000); }这段代码看起来简单，但有个先后顺序的坑：HAL 库要求HAL_RTC_GetTime放在HAL_RTC_GetDate之前，一旦先调用了 GetDate，RTC 的影子寄存器会把时间值锁住，你读到的秒钟会一直不变。真遇到时间不动，先确认是不是这个顺序问题，再去怀疑晶振。
跑通这个最小工程后，串口应该能稳定输出递增的秒数。如果输出是乱的或者卡住，直接跳到第 4 章的排查清单。
3. 闹钟、备份寄存器与 VBAT 掉电保持：把 RTC 用进产品的三块基石
3.1 RTC 闹钟：在指定时刻触发中断，做定时上报或定时休眠
RTC 不只是给你读时间的，它最有价值的能力是闹钟：在设定的时分秒触发一次中断，让处于 STOP 模式的芯片醒过来干活。配置代码如下：
RTC_AlarmTypeDef sAlarm = {0}; sAlarm.AlarmTime.Hours = 8; sAlarm.AlarmTime.Minutes = 30; sAlarm.AlarmTime.Seconds = 0; // 屏蔽日期和星期，只匹配时分秒，实现每天 08:30:00 触发 sAlarm.AlarmMask = RTC_ALARMMASK_DATE_WEEKDAY; HAL_RTC_SetAlarm_IT(&hrtc, &sAlarm, RTC_ALARM_A);AlarmMask是最容易配错的地方。如果你想实现「每天定点执行一次」，必须把日期和星期掩码都置上；如果只掩了日期没掩星期，RTC 会拿当前星期几和你没有初始化的星期字段做比较，结果就是闹钟要么不触发，要么每天触发时间随机漂移。老工程师习惯先把掩码全置位，再逐步放开需要匹配的字段，这样排查起来最直接。
闹钟中断的优先级建议设为独立且较低的抢占优先级，避免和主业务中断互相挤占。在中断回调里只做一个动作：置标志位，把延时处理扔回主循环，不要在 RTC 中断里跑 I2C 或写 Flash，否则唤醒流程会被拖慢几个毫秒，低功耗优化的意义就没了。
3.2 备份寄存器：掉电不丢的标记区，用来记录重启原因
备份寄存器是 RTC 模块里经常被忽略的免费资源。它和 RTC 一样挂在 VBAT 电源域上，主电源掉了也还在，直到纽扣电池耗尽。典型用途是记录复位原因、上次关机时间、累计开机次数。
// 写入一个标记：0xA5A5 表示上次是看门狗复位，0x5A5A 表示掉电重启 __HAL_RTC_BKP_ENABLE(&hrtc); HAL_RTCEx_BKUPWrite(&hrtc, RTC_BKP_DR1, 0xA5A5); // 读回判断 uint32_t reason = HAL_RTCEx_BKUPRead(&hrtc, RTC_BKP_DR1); if (reason == 0xA5A5) { // 看门狗复位处理 }大部分 STM32 系列提供 20 到 32 个备份寄存器，每个 32 位，用来存业务状态足够用。但注意：这些寄存器不是无限写入寿命的，虽然绝大多数产品用不到寿命上限，但如果你在掉电检测中断里频繁写，要加写入间隔保护，避免极端场景下把备份域写坏。
3.3 VBAT 电源域：纽扣电池与主电源的自动切换电路
RTC 电路设计上，VBAT 不是简单的电源引脚，它整个电源域（the vbat power domain）耗电极小，典型只有微安级，里面包含 RTC 和 LSE 振荡器。主电源在时由 VDD 供电，主电源掉后自动切到 VBAT 引脚上的电池。因为功耗足够低，一颗常见规格的纽扣电池撑几年是正常的。
| 节点 | 接法 | 说明 |
|---|---|---|
| VBAT | CR2032 正极 | 掉电期间给 RTC + LSE 供电 |
| 电池负极 | GND | 必须与系统共地 |
| VDD | 系统 3.3V | 正常工作时给 VBAT 域供电 |
| VDD 到 VBAT | 串联低压差二极管 | 防止电池倒灌到 VDD |
| 电池正极到 VBAT | 串联 100Ω 电阻 | 限流，防止热插拔打火 |
我见过很多抄板把 VBAT 直接接到 VDD，这样省了电池、省了二极管，但也把掉电保时功能废了——主电一断，RTC 立刻失忆。还有人在 VBAT 上并了 10uF 电容想滤波，结果掉电瞬间电池给电容充电，把本来能走半年的电量几天耗光。记住了：VBAT 链路越简单越可靠。
3.4 一个常见误区：以为主电源掉电后 MCU 还在工作
很多嵌入式新手对掉电保时的理解是「MCU 靠电池还在跑」，这是错的。掉电后整个主内核都停了，只有 VBAT 域里的 RTC 和 LSE 在走，软件不再执行任何指令。你上电后看到的时间，是 RTC 硬件寄存器在电池供电下持续累加的结果。
所以如果 rtc.rar_RTC 里的代码用的是 LSI，掉电一发生 RTC 就停了，时间自然回到上电初值。判断一份 RTC 方案能不能满足产品需求，不用看代码写得漂不漂亮，先查时钟源是不是 LSE、VBAT 链路有没有设计，这两个问题定了，方案的基本盘就定了。
4. RTC 走时与晶振排查：LSE 起振失败的 5 个必查点
这一节写的是我在实际调试 RTC 电路时踩过的真实坑，按照现象→原因→解决来写，每一类都对应一条独立排查路径。如果你发现 RTC 不走了，从上往下查大概率能定位。
4.1 LSE 起振失败，初始化卡死或时间不走
现象：程序烧进去后，串口没有输出，或者 RTC 时间始终停在 00:00:00 不动，偶尔系统还会跑飞。
原因：LSE 晶振没起振。起振失败的物理原因很多：晶振焊盘虚焊、引脚存在助焊剂残留、负载电容容值不对、PCB 走线过长耦合噪声。最容易被忽略的是，LSE 对负载电容极其敏感，32.768kHz 晶振的负载电容规格通常在 6pF 到 12.5pF 之间，你用手边随便找的 22pF 电容大概率起振不了。
解决：先用示波器探头点在 OSC32_IN 引脚看有没有 32.768kHz 正弦波，没有就换负载电容，通常从两个 6.8pF 起步试起振。手动在示波器上测 LSE 时务必使用高阻探头，普通 1MΩ 探头会把振荡幅度拉没。实在没有示波器，串口打印LSERDY标志位，卡住就说明 LSE 还没好。我在现场干过最土但有效的一招：手指摁住晶振外壳，如果时间开始走了，基本就是负载电容失配。
4.2 走时一天慢几十秒：负载电容与晶振匹配问题
现象：RTC 能走，但一天慢 30 秒以上，用示波器测 LSE 频率发现只有 32.767kHz 甚至更低。
原因：晶振实际振荡频率取决于负载电容。计算方式是 CL = (C1 × C2) / (C1 + C2) + 引脚寄生电容，MCU 引脚寄生一般在 2~4pF。比如你选了 12.5pF 负载电容的晶振，却在 OSC_IN、OSC_OUT 各接了 22pF 电容，两电容串联等效 11pF，加上寄生电容总负载约 14pF，频率会明显偏低。
解决：用频率计测量 OSC_OUT 引脚的实际频率，然后按差值调整电容。频率偏低就减小电容，频率偏高就增大电容。这一步是玄学，但可以用公式锚定一个起点：若晶振规格书标 12.5pF，先装两个 20pF，实测再换成 15pF 或 10pF 微调。批量生产时电容精度选 C0G/NPO 材质，别用 X5R，X5R 的温漂会让走时精度在冬夏之间漂出几十 ppm。
4.3 备份域被意外复位，时间凭空清零
现象：产品运行正常，但偶尔上电后时间回到了 2000 年 1 月 1 日，RTC 备份寄存器的值也全丢了。
原因：备份域被软件或硬件复位。常见诱因有两个：一是代码里在 RTC 初始化前调用了备份域复位函数，比如 HAL 库里的__HAL_RCC_BACKUPRESET_FORCE()，这条命令会同时清掉 RTC 寄存器和备份寄存器；二是 NRST 引脚受到干扰毛刺触发复位，部分 MCU 的备份域复位会连带清掉 RTC 配置。
解决：不要在产品代码里随便执行备份域复位，该操作只应在出厂首次烧录时调用一次。检查复位标志寄存器里的 RST 来源，如果异常复位源频繁出现，去看 NRST 引脚有没有串电容做滤波，或者主电源上电时序是否产生跌落，导致芯片在临界电压下反复复位。真需要保留时间，还要检查你的初始化流程是否每次上电都把 RTC 重新写一遍——正确做法是首次检测到备份寄存器是空时才初始化，否则直接跳过写入。
4.4 掉电后时间丢失：VBAT 供电链路问题
现象：接上电池，上电也写了正确时间，断电几分钟再上电，时间还是丢。
原因：VBAT 引脚上根本没电，或者电压低于 RTC 保持所需的最低值。最容易出问题的是那个防倒灌二极管，低压差二极管也有 0.3V 压降，如果电池标称 3.0V，掉到 2.6V 后剩下的电压可能低于 RTC 工作电压阈值，时间就开始丢失。另外 PCB 上的助焊剂在潮湿环境下会在 VBAT 与 GND 之间形成漏电通路，把纽扣电池电量缓慢放掉。
解决：用万用表量 VBAT 引脚对地电压，断电状态下应等于电池电压减去二极管压降。再用微安档串联在电池回路里量静态电流，正常应该在 1~5uA 左右，如果量出几十微安，说明 PCB 有漏电。最后确认 PCB 清洗工序到位，特别是 RTC 晶振引脚附近不要残留助焊剂。
4.5 校准寄存器越校越偏：先测 ppm 再动手
现象：代码里写了 RTC 校准函数，也按手册填了校准值，结果走时偏差反而从一天 2 秒变成了一天 10 秒。
原因：校准方向填反了。RTC 校准寄存器的值是带符号的，有的 MCU 用正数表示增加频率，有的表示减少频率，不同厂商定义恰好相反。还有人不做测量直接照搬网上的校准参数，实际每颗晶振的初始频偏都不一样，固定值自然只能对一部分板子有效。
解决：先测出当前实际偏差。整点用标准时间源对齐 RTC，跑满 24 小时再对比，算出 ppm 后再去查手册校准公式。公式：偏差秒数 / 86400 × 1000000 就是 ppm，走慢了填加速值，走快了填减速值。每块板子都校准成本高，常见做法是产线只测一次频偏，按批次统一写校准参数，但要保证晶振来料批次稳定。
5. 低功耗唤醒与时间校准：把 RTC 从「读时间」用到「管功耗」
5.1 RTC 闹钟唤醒 STOP 模式：微安级待机的关键配置
很多产品的电池寿命是由待机电流决定的：设备大部分时间睡在 STOP 模式，靠 RTC 闹钟在固定时刻叫醒干活。典型的配置是每天整点醒来采集一次数据，然后继续睡。
// 配置每天 10:00:00 的闹钟唤醒 RTC_AlarmTypeDef sAlarm = {0}; sAlarm.AlarmTime.Hours = 10; sAlarm.AlarmTime.Minutes = 0; sAlarm.AlarmTime.Seconds = 0; sAlarm.AlarmMask = RTC_ALARMMASK_DATE_WEEKDAY; HAL_RTC_SetAlarm_IT(&hrtc, &sAlarm, RTC_ALARM_A); // 进入 STOP 模式等待唤醒 HAL_SuspendTick(); HAL_PWR_EnterSTOPMode(PWR_LOWPOWERREGULATOR_ON, PWR_STOPENTRY_WFI); // 唤醒后补充处理 HAL_ResumeTick(); SystemClock_Config(); // STOP 模式会丢掉主时钟配置，必须重新做这里有两个细节决定成败。第一，进入 STOP 前必须调用HAL_SuspendTick()，否则 SysTick 中断会把系统拖出睡眠。第二，唤醒后主时钟需要重新配置，因为 STOP 模式把 HSE/PLL 都停了，直接跑在默认 HSI 上会导致串口波特率错乱。实测这类方案待机电流能做到 3uA 以下，其中 RTC 域占 1~2uA，其余是 DC-DC 静态损耗。
5.2 用 RTC WakeUpTimer 做周期唤醒：比闹钟更省资源
如果唤醒周期是固定的 1 秒、10 秒、60 秒，用 WakeUpTimer 比闹钟更合适。它不需要设置时间点，只需要一个自动重装载计数器和唤醒时钟源，实现一个纯粹的周期定时器。
// 使用 1Hz 校准时钟作为唤醒源，每 60 秒唤醒一次 HAL_RTCEx_SetWakeUpTimer_IT(&hrtc, 59, RTC_WAKEUPCLOCK_CK_SPRE_1HZ);参数含义：第一个参数是重装载值，从 0 开始计数，想要 60 秒就填 59；第二个参数选择时钟源，CK_SPRE_1HZ是内部校准过的 1Hz 信号，RTCCLK/16则直接从 LSE 分频，精度更高但功耗略增。重装载值最大可以支持数小时的周期，不需要频繁重启定时器。
用 WakeUpTimer 比闹钟少走一层比较逻辑，代码也更简单。很多参考例程喜欢用闹钟做周期性唤醒，原因是闹钟可以选任意时刻点到，但实际固定周期的场景 WakeUpTimer 够用，而且闹钟中断里还要额外处理日期字段匹配的坑。
5.3 网络校时：把 NTP 时间写进 RTC 的落地做法
设备联网后，不能让 RTC 一直自由漂移，必须隔一段时间用标准时间源校准一次。最常见做法是定时从 NTP 服务器拿到 UTC 时间戳，再转换为本地时间写进 RTC。
uint32_t ts = GetNtpTimestamp(); // 网络返回的 UTC 秒数 time_t rawtime = (time_t)ts; struct tm *t = localtime(&rawtime); // 转成本地时间，已处理时区 RTC_DateTypeDef d; d.Year = t->tm_year - 100; // tm_year 从 1900 算起，RTC 只存 00~99 d.Month = t->tm_mon + 1; // tm_mon 从 0 开始 d.Date = t->tm_mday; d.WeekDay = t->tm_wday + 1; // RTC 的星期从 1 开始 HAL_RTC_SetDate(&hrtc, &d, RTC_FORMAT_BIN); RTC_TimeTypeDef t2; t2.Hours = t->tm_hour; t2.Minutes = t->tm_min; t2.Seconds = t->tm_sec; HAL_RTC_SetTime(&hrtc, &t2, RTC_FORMAT_BIN);这里要注意tm_year是从 1900 年开始的年数，转成 RTC 年份要减 100，得到 00~99 的两位数。tm_mon的范围是 0~11，月份要加 1。时区和夏令时的处理交给localtime是最高效的路径，不要自己在嵌入式代码里硬算时区偏移，容易在跨年时踩坑。
写回 RTC 的时间建议只在 UTC 整数分钟变化时做，避免每次校时都把 RTC 中断一次。多数低功耗产品一天校时一次就够，因为 LSE 晶振的温漂是长期缓慢过程，短时抖动不会改变整体精度。
6. 给 RTC 驱动加一道保险：上电回读校验与走时误差测试
6.1 上电自检：读回校验函数
RTC 驱动写完之后，不要直接信任初始化成功的返回码。有一次我遇到过初始化 HAL 返回 OK，但时间寄存器实际没有起振，秒值不动，这时候只有读回校验能把问题暴露出来。
uint8_t RTC_CheckRunning(void) { RTC_TimeTypeDef t1 = {0}; RTC_TimeTypeDef t2 = {0}; HAL_RTC_GetTime(&hrtc, &t1, RTC_FORMAT_BIN); HAL_Delay(250); HAL_RTC_GetTime(&hrtc, &t2, RTC_FORMAT_BIN); if (t1.Seconds == t2.Seconds) { return 0; // 250ms 内秒值没变化，判定 RTC 未运行 } return 1; }这个函数放到每次上电初始化之后调用，返回失败就点亮告警灯或者上报错误码。250ms 的延时里至少要跨过 1 秒的边界，所以延时选 250ms 是够的，如果想更保险可以改成 1100ms，确保一定跨过秒边界。唯一要留意的是函数内部调用了 HAL_Delay，在上电刚初始化完成时 SysTick 必须已经工作，否则会卡在延时里。
6.2 走时精度测量：24 小时偏差换算 ppm
RTC 精度最终要看实测数据。我的做法是：找一个标准时间源（手机秒表或 GPS 时间），把设备时间校准到整点，记下当前 RTC 时间，跑满 24 小时后再次对比。偏差 1 秒就是约 11.5 ppm 的频偏，公式是偏差秒数除以 86400 再乘以 1000000。这个 ppm 值就是你决定要不要打开硬件校准功能的依据：如果一天偏差在 2 秒以内，说明晶振匹配良好，不需要动校准寄存器；如果一天偏差超过 5 秒，多半是负载电容没匹配好，光靠校准寄存器能救一部分，但不如先回头调硬件。
每次新打板回来，我都会先在首件上做这个 24 小时测试，确认 LSE 起振余量和频偏方向，而不是直接批量烧程序。这个习惯帮我挡掉了两批晶振来料异常的问题。RTC 是一个看起来简单、实际翻车率极高的外设，多花 24 小时验证一次，比量产后再召回划算得多。希望帮到你。
本文还有配套的精品资源，点击获取
