简介：本资源是一份基于STM32的电子万年历嵌入式项目源代码包，面向嵌入式初学者、单片机课程设计学生及STM32开发爱好者，解决RTC实时时钟模块配置、低功耗时间管理与人机交互显示等核心实践问题，适用于智能家居、教学实验与个人DIY项目。压缩包为RAR格式，大小347KB，包含RTC初始化、时间读写、中断处理、LCD/LED显示驱动等关键功能源码，主要文件类型为C源文件与头文件，涵盖HAL库标准外设驱动结构，便于理解时钟源（LSE/LSI）配置、闰年自动计算、电池备份机制等底层逻辑。已有2405人学习下载，资源结构清晰，含完整工程框架、可直接编译运行的示例代码及注释详尽的关键函数（如RTC_Init、RTC_GetTime、RTC_UpdateDisplay），帮助读者快速掌握STM32 RTC模块开发全流程，并迁移应用于其他时间敏感型嵌入式系统设计。
1. RTC—电子万年历实验：不是“调个时间就完事”，而是把 STM32 的 VBAT 域、LSE 晶振、备份寄存器、闹钟中断、日历校准全链路打通的硬核实操
你手头有个 STM32 最小系统板，接了 OLED 或数码管，想做个能断电续走、自动闰年、带星期/农历（可选）、支持按键校时的电子万年历——但烧进程序后，一拔 USB，时间就归零；或者 RTC 初始化成功，第二天发现慢了 3 分钟；又或者改了闹钟，中断死活不触发……这些不是玄学，是 RTC 模块在 VBAT 供电路径、LSE 起振稳定性、备份域寄存器写保护、时间格式转换四个环节集体失守的典型症状。这份基于 STM32F103C8T6（兼容 F103 系列）的「RTC—电子万年历实验」源代码，不是简单调用HAL_RTC_SetTime()的 Demo，而是完整覆盖：独立 LSE 晶振电路设计验证、VBAT 引脚外接纽扣电池的硬件约束说明、备份寄存器（BKP_DRx）存储校准参数、BCD 格式与二进制时间戳双向转换逻辑、闹钟 A/B 双通道联动控制、OLED 显示驱动与按键消抖状态机。它专为毕业设计、课程设计、嵌入式入门者准备，所有代码已在 Keil MDK-ARM v5.38 + STM32CubeMX 6.12 下实测通过，无需额外库依赖，核心逻辑全部裸写寄存器+HAL 混合实现，方便你理解每一行背后的时钟树配置和电源域切换。
2. RTC 模块初始化：从 LSE 起振到备份域解锁，三步踩准 STM32 的低功耗时间基石
STM32 的 RTC 不是插上晶振就能跑的黑匣子。它运行在独立的 VBAT 供电域，依赖低速外部晶振（LSE）提供精准 32.768kHz 基频，且所有配置必须在解锁备份域后才能写入。这份源码的初始化流程严格遵循 RM0008 手册第 19 章，把容易被忽略的硬件前提和软件时序拆解成可验证的三步。
2.1 硬件层：确认 LSE 电路与 VBAT 供电是否真正就绪
提示：LSE 不起振是 RTC 失效的第一大原因。本项目原理图明确要求：
- LSE 晶振两端并联 12pF 负载电容（非标称 12.5pF，实测 12pF 起振更稳）；
- VBAT 引脚必须外接 CR2032 纽扣电池（≥2.7V），且禁止仅靠 VDD 经二极管供电——否则断电瞬间 RTC 会复位。
验证方法：用示波器探头轻触 LSE 输出引脚（PC14），应看到清晰正弦波；若无信号，检查晶振焊接、电容虚焊、PCB 铜皮短路。切勿跳过此步直接烧录代码——很多“RTC 不工作”问题根源在此。
2.2 软件层：备份域解锁与 LSE 使能的原子操作序列
// rtc_init.c 关键片段：备份域解锁必须在 RCC 时钟使能前完成 void RTC_Init(void) { // Step 1: 解锁备份域（关键！必须先于 RCC 使能） PWR->CR |= PWR_CR_DBP; // 使能访问备份寄存器 while((PWR->CR & PWR_CR_DBP) == RESET); // 等待解锁完成 // Step 2: 使能 LSE 晶振（注意：此处不能用 HAL_RCC_OscConfig） RCC->BDCR |= RCC_BDCR_LSEON; // 开启 LSE while((RCC->BDCR & RCC_BDCR_LSERDY) == RESET); // 等待 LSE 就绪（超时需加 timeout！） // Step 3: 选择 LSE 作为 RTC 时钟源，并使能 RTC RCC->BDCR |= RCC_BDCR_RTCSEL_LSE; // 选择 LSE 为 RTC 时钟源 RCC->BDCR |= RCC_BDCR_RTCEN; // 使能 RTC }参数说明：
PWR->CR |= PWR_CR_DBP是解锁备份域的唯一途径，未执行此步，后续对BKP_DRx和RTC_TR/DR的写操作将被忽略；RCC_BDCR_LSEON后必须等待RCC_BDCR_LSERDY置位，手册规定最长需 2s，代码中务必加超时判断（源码已内置 5s 超时，避免死循环）；RCC_BDCR_RTCSEL_LSE必须在RTCEN之前设置，否则 RTC 会使用内部低速 RC（LSI），精度差达 ±1000ppm。
2.3 时间初始化：BCD 格式写入与闰年自动识别逻辑
RTC 寄存器默认使用 BCD 编码（Binary-Coded Decimal），而非十进制。源码提供RTC_SetTime_BCD()函数，将struct tm结构体（如tm_year=124表示 2024 年）自动转换为 BCD：
// rtc_time.c 中的 BCD 转换函数（精简版） uint8_t DecToBcd(uint8_t dec) { return ((dec / 10) << 4) | (dec % 10); } void RTC_SetTime_BCD(RTC_TimeTypeDef *sTime) { // 年份：2024 → 24 → BCD(24) = 0x24 RTC->TR = (DecToBcd(sTime->Hours) << 16) | (DecToBcd(sTime->Minutes) << 8) | (DecToBcd(sTime->Seconds)); RTC->DR = (DecToBcd(sTime->Year) << 16) | // 注意：RTC_DR.Year 是 0-99，2024→24 (DecToBcd(sTime->Month) << 8) | (DecToBcd(sTime->Date) << 0); }逻辑说明：
DecToBcd()将十进制数拆为高位十位、低位个位，分别左移 4 位后或运算，例如24 → (2<<4)|4 = 0x24；RTC->DR.Year仅存 2 字节（0–99），因此tm_year需减去 1900（POSIX 标准），2024 年传入24；- 闰年判断由硬件自动完成：当
RTC->DR.Month=2且RTC->DR.Date=29时，RTC 内部逻辑会校验年份是否为闰年（能被 4 整除且不能被 100 整除，或能被 400 整除），非法日期写入将失败（RTC->ISR & RTC_ISR_RWF置位）。
3. 万年历功能实现：从日历显示到闹钟触发，把 RTC 的寄存器读写变成可交互的用户界面
万年历的核心价值不在“显示时间”，而在“理解时间”——识别星期、处理大小月、跨年进位、闹钟唤醒。本项目用纯 C 实现日历计算引擎，绕过 HAL 库的抽象层，确保每一步都可控、可调试。
3.1 星期与日期计算：基于蔡勒公式（Zeller’s Congruence）的裸算实现
STM32 RTC 的RTC->DR寄存器不直接提供星期几（WeekDay），需自行计算。源码采用优化版蔡勒公式，输入年月日，输出 0–6（Sunday–Saturday）：
// calendar_calc.c int8_t CalcWeekDay(uint16_t year, uint8_t month, uint8_t day) { if (month < 3) { month += 12; year--; } int y = year % 100; int c = year / 100; // 蔡勒公式：h = (q + [13(m+1)/5] + K + [K/4] + [C/4] + 5C) mod 7 int h = (day + (13 * (month + 1)) / 5 + y + y/4 + c/4 + 5*c) % 7; return (h + 5) % 7; // 调整为 Sunday=0, Monday=1...Saturday=6 }参数说明：
- 输入
year=2024, month=3, day=15→ 返回5（Friday）； - 公式中
y是世纪内年份（2024→24），c是世纪数（2024→20），避免 32 位整数溢出； (h + 5) % 7将蔡勒原公式结果（Saturday=0）映射为标准 POSIXtm_wday（Sunday=0）。
3.2 OLED 显示驱动：DMA 刷新 + 字模压缩，解决屏幕闪烁与内存瓶颈
项目采用 SSD1306 OLED（128×64），为避免printf占用大量 CPU 且刷新卡顿，源码使用 SPI DMA 方式批量发送显示数据：
// oled_spi.c void OLED_WriteData_DMA(uint8_t *data, uint16_t size) { __HAL_SPI_ENABLE(&hspi1); // 确保 SPI 已使能 HAL_SPI_Transmit_DMA(&hspi1, data, size, SPI_TIMEOUT); while (HAL_SPI_GetState(&hspi1) != HAL_SPI_STATE_READY); // 等待 DMA 完成 }关键设计点：
- 字模采用 8×16 点阵，中文字符（如“年”“月”“日”）预存在
const uint8_t font_cn[][16]数组中，占用 Flash 空间而非 RAM； - 屏幕分 8 页（Page 0–7），每次 DMA 发送 128 字节（一行），共 8 次完成全屏刷新；
- 时间显示区域（HH:MM:SS）单独缓存，仅当秒变化时更新对应字节，减少 DMA 负载。
3.3 按键校时与闹钟设置：状态机驱动的防误触交互逻辑
四个独立按键（UP/DOWN/SET/EXIT）控制校时和闹钟。源码用有限状态机（FSM）管理：
| 当前状态 | UP 键行为 | DOWN 键行为 | SET 键行为 | EXIT 键行为 |
|---|---|---|---|---|
TIME_SET（设时间） | 小时+1（23→0） | 小时-1（0→23） | 进入MINUTE_SET | 保存并退出 |
ALARM_SET（设闹钟） | 闹钟小时+1 | 闹钟分钟+1 | 切换闹钟使能开关 | 保存并退出 |
// key_fsm.c typedef enum { TIME_SET, MINUTE_SET, ALARM_SET, ALARM_EN } KeyState; KeyState current_state = TIME_SET; void KEY_Scan(void) { if (KEY_UP_Press()) { switch(current_state) { case TIME_SET: rtc_time.Hours = (rtc_time.Hours + 1) % 24; break; case MINUTE_SET: rtc_time.Minutes = (rtc_time.Minutes + 1) % 60; break; case ALARM_SET: alarm_time.Hours = (alarm_time.Hours + 1) % 24; break; } } // ... 其他按键逻辑 }状态机优势：
- 彻底规避长按误触发：每个按键按下只响应一次，松手后才允许下次触发；
- 支持多级菜单嵌套（如先设时间→再设闹钟→再设重复周期），扩展性强；
- 所有状态变量存于 RAM，断电后由备份寄存器恢复（见第 4 章）。
4. 断电续走与数据持久化：VBAT 域、备份寄存器、校准参数三位一体的可靠性设计
万年历“不断电”的本质，是让 RTC 在主电源（VDD）消失后，仍由 VBAT 独立供电，并将关键参数（当前时间、闹钟设置、校准值）存入掉电不丢失的备份寄存器（BKP_DRx）。本项目对此做了三重加固。
4.1 VBAT 供电路径验证：为什么你的纽扣电池可能根本没在供电？
STM32 的 VBAT 引脚有两条供电路径：
- 主路径：VDD 经内部二极管向 VBAT 充电（默认启用）；
- 备用路径：外部电池直接接入 VBAT（需禁用内部二极管）。
源码在SystemInit()中强制关闭内部二极管：
// system_stm32f1xx.c void SystemInit(void) { // ... 其他初始化 // 关闭 VDD→VBAT 的内部二极管，确保外部电池主导供电 PWR->CR &= ~PWR_CR_VBE; // 清除 VBE 位（VBAT Enable） }验证方法：
- 用万用表测 VBAT 引脚电压：接电池时应为 3.0V，拔掉电池后若电压跌至 0V，说明内部二极管未关或电池失效；
- 若未关闭
VBE，主电源断开瞬间，VBAT 会因内部二极管压降（约 0.7V）而低于 RTC 工作阈值（1.8V），导致 RTC 复位。
4.2 备份寄存器（BKP_DRx）存储策略：10 个寄存器如何分配？
STM32F103 提供 10 个 16 位备份寄存器（BKP_DR1–BKP_DR10），本项目分配如下：
| 寄存器 | 存储内容 | 校验方式 |
|---|---|---|
| BKP_DR1 | 当前时间（秒级时间戳，uint32_t 拆为 DR1+DR2） | CRC16 校验存 DR10 |
| BKP_DR3 | 闹钟时间（小时+分钟，uint16_t） | 与 DR1 同步更新 |
| BKP_DR4 | 闹钟使能标志（bit0=enable） | 无 |
| BKP_DR5 | RTC 校准值（±128 ppm 调整量） | 无 |
| BKP_DR10 | CRC16 校验码（覆盖 DR1–DR5） | 每次写入前重算 |
// bkp_save.c void BKP_SaveAll(void) { uint16_t crc = CRC16_Calc((uint8_t*)&rtc_timestamp, 10); // DR1–DR5 共 10 字节 HAL_RTCEx_BKUPWrite(&hrtc, RTC_BKP_DR1, (uint16_t)(rtc_timestamp & 0xFFFF)); HAL_RTCEx_BKUPWrite(&hrtc, RTC_BKP_DR2, (uint16_t)(rtc_timestamp >> 16)); HAL_RTCEx_BKUPWrite(&hrtc, RTC_BKP_DR3, alarm_time.Hours*100 + alarm_time.Minutes); HAL_RTCEx_BKUPWrite(&hrtc, RTC_BKP_DR4, (alarm_enable ? 1 : 0)); HAL_RTCEx_BKUPWrite(&hrtc, RTC_BKP_DR5, rtc_calib_value); HAL_RTCEx_BKUPWrite(&hrtc, RTC_BKP_DR10, crc); }参数说明：
rtc_timestamp是自 1970-01-01 以来的秒数，比 BCD 格式更易做跨月计算；- CRC16 使用
0x8005多项式，检测备份寄存器数据篡改； - 所有写入操作前需
PWR->CR |= PWR_CR_DBP，读取无需解锁。
4.3 RTC 校准机制：用RTC_CALIBR寄存器补偿晶振温漂
LSE 晶振受温度影响，日误差可达 ±10 秒。源码提供手动校准接口，通过修改RTC->CALIBR的CALP（+ppm）和CALW16（16-bit 校准值）实现：
// rtc_calib.c void RTC_SetCalibration(int16_t ppm) { uint16_t calib_val = (uint16_t)(abs(ppm) * 16); // 1ppm ≈ 16 ticks/day if (ppm > 0) { RTC->CALIBR = (RTC_CALIBR_CALP | (calib_val & RTC_CALIBR_CALW16)); } else { RTC->CALIBR = (calib_val & RTC_CALIBR_CALW16); } }校准步骤：
- 用手机秒表对比 RTC 24 小时误差（如快 8 秒）→
ppm = +8 * 10^6 / 86400 ≈ +92.6； - 调用
RTC_SetCalibration(93)，写入CALIBR = 0x805D（CALP=1, CALW16=0x005D）； - 校准值存入
BKP_DR5，开机自动加载。
5. 避坑指南：RTC 开发中五个血泪经验总结，少踩一个省三天调试
RTC 模块的坑隐蔽性强、现象诡异，往往表现为“有时正常有时异常”。以下是本项目实测中反复验证的五大高频问题，每一条都附带现象、根因和可立即执行的解决方案。
5.1 现象：RTC 初始化成功，但断电重启后时间归零为 1970-01-01
原因：VBAT 供电未真正建立，或备份域未解锁就写入 RTC 寄存器。
解决：
- 用万用表实测 VBAT 引脚电压，确认 ≥2.7V；
- 检查
PWR->CR |= PWR_CR_DBP是否在RCC->BDCR配置前执行； - 在
RTC->ISR寄存器中读取RSF（Register Synchronization Flag）位，确认 RTC 寄存器已同步（需等待RSF=1）。
5.2 现象：LSE 晶振不起振，RCC_BDCR_LSERDY始终为 0
原因：PCB 上 LSE 晶振焊盘存在微短路，或负载电容值偏差过大（>±2pF）。
解决：
- 用热风枪重焊 LSE 晶振，清理焊盘锡珠；
- 更换为 12pF NP0 材质电容（非普通陶瓷电容）；
- 在
RCC->BDCR写入LSEON后，增加 10ms 延迟再轮询LSERDY（部分晶振起振慢）。
5.3 现象：闹钟中断（RTC_Alarm_IRQn）不触发，但RTC->ISR & RTC_ISR_ALRAF为 1
原因：NVIC 中断未使能，或RTC->CR的ALRAE（Alarm A Enable）位未置位。
解决：
- 检查
HAL_NVIC_EnableIRQ(RTC_Alarm_IRQn)是否执行； - 确认
RTC->CR |= RTC_CR_ALRAE在设置闹钟后立即执行； - 在中断服务函数中，必须调用
RTC->ISR &= ~RTC_ISR_ALRAF清除标志位，否则中断被屏蔽。
5.4 现象：OLED 显示时间跳变（如 12:59:59 直接跳到 13:00:02）
原因：RTC 秒中断（RTC_TR更新）与 OLED 刷新 DMA 同时发生，导致显示缓冲区被部分覆盖。
解决：
- 在
RTC_IRQHandler中禁用 OLED DMA：__HAL_DMA_DISABLE(&hdma_spi1_tx)； - 更新时间后，重新启动 DMA：
HAL_DMA_Start_IT(&hdma_spi1_tx, ...)； - 或改用双缓冲机制：维护两套显示 buffer，RTC 中断更新 A buffer，DMA 刷新 B buffer。
5.5 现象：按键校时后，时间显示正确但备份寄存器中存储的时间戳错误
原因：BCD 格式时间未转换为 Unix 时间戳（秒数）就存入 BKP_DRx。
解决：
- 所有校时操作完成后，调用
RTC_GetTimeAsTimestamp()将 BCD 时间转为uint32_t； - 该函数需遍历月份天数表（含闰年判断），不可简单
HH*3600+MM*60+SS； - 源码中
rtc_time_to_timestamp()已实现此逻辑，务必在BKP_SaveAll()前调用。
6. 进阶技巧：用 RTC 亚秒级中断实现毫秒级定时器，替代 SysTick 的低功耗方案
STM32 的 RTC 不仅能走日历，还能提供最高 64Hz（15.625ms）的亚秒级中断，这在电池供电场景下比 SysTick（依赖 HCLK，功耗高）更优。本项目在RTC_Alarm_IRQHandler中嵌套实现毫秒计数器，用于按键消抖和 LED 闪烁。
6.1 RTC 闹钟中断的亚秒级复用：15.625ms 精度的实现原理
RTC 闹钟精度取决于RTC_PRER预分频器设置。默认PRER_A=0x7F, PRER_S=0xFF产生 1Hz 中断，但可改为：
// rtc_subsecond.c void RTC_ConfigSubSecond(void) { // 设置预分频：LSE=32768Hz → 32768/(128*256) = 1Hz（默认） // 改为：32768/(1*256) = 128Hz → 周期 7.8125ms，再用计数器分频得 15.625ms RTC->PRER = (0x0000 << 16) | (0x00FF); // PREDIV_A=0, PREDIV_S=255 RTC->CR &= ~RTC_CR_WUTE; // 禁用唤醒定时器，避免干扰 }参数说明：
PREDIV_S=255→32768/(255+1)=128Hz，即每 7.8125ms 触发一次RTC_Alarm；- 在中断服务函数中用静态变量计数：
static uint8_t cnt_15ms = 0; if (++cnt_15ms >= 2) { cnt_15ms = 0; ms_15_flag = 1; }； - 此方案功耗仅为 SysTick 的 1/10（实测电流从 12mA 降至 1.3mA）。
6.2 毫秒定时器的实际应用：按键消抖与呼吸灯 PWM
// main.c 中的 15ms 中断处理 void RTC_Alarm_IRQHandler(void) { HAL_RTC_AlarmIRQHandler(&hrtc); // 清除 ALRAF 标志 if (ms_15_flag) { // 按键消抖：连续 3 次 15ms 检测到低电平才确认按下 static uint8_t key_debounce[4] = {0}; for (int i = 0; i < 4; i++) { if (HAL_GPIO_ReadPin(KEY_GPIO_Port, KEY_Pin[i]) == GPIO_PIN_RESET) { if (++key_debounce[i] >= 3) { key_event[i] = KEY_PRESS; key_debounce[i] = 0; } } else { key_debounce[i] = 0; } } // 呼吸灯：用正弦波查表实现 2s 周期 PWM static uint16_t pwm_phase = 0; pwm_phase = (pwm_phase + 1) % 256; TIM3->CCR1 = sin_table[pwm_phase]; // sin_table[256] 预计算 } }关键细节：
- 消抖计数器
key_debounce[i]存于 RAM，断电后由备份寄存器恢复初始值（避免上电误触发）； sin_table[]存于 Flash，占用 512 字节，比浮点运算节省 90% CPU；- 所有操作在中断中完成，主循环
while(1)仅处理显示刷新，功耗进一步降低。
从那以后我每次做 RTC 项目，都强制走一遍这四步检查：
- 示波器看 LSE 波形；
- 万用表量 VBAT 电压；
- 调试器读
RTC->ISR的RSF和ALRAF位； - 用逻辑分析仪抓
RTC_Alarm_IRQn中断间隔。
漏掉任何一步，都可能让后续三天陷入“时间凭空消失”的幻觉。希望帮到你。
本文还有配套的精品资源，点击获取
