STM32F103 RTC日期跨天就归零？一个HAL库的‘坑’与我的填坑实战

张

张建站

2026/4/24 17:11:21

10分钟阅读

ST32F103 RTC日期跨天归零问题从硬件差异到HAL库的深度修复指南凌晨三点调试器的蓝光映在布满咖啡渍的键盘上——这已经是本周第三次被RTC日期异常问题打断睡眠。作为嵌入式开发者当产品在客户现场出现时空错乱那种头皮发麻的体验想必都不陌生。本文将揭示STM32F103系列中那个让无数工程师栽跟头的日期归零陷阱不同于网上泛泛而谈的解决方案我们将从芯片硬件设计差异出发直指HAL库函数底层逻辑缺陷提供两种经量产验证的修复方案。1. 问题本质F1与F4的RTC硬件架构差异翻开STM32F103和F4系列的参考手册RTC章节的差异令人惊讶。F4系列采用独立供电域的双寄存器设计时间寄存器RTC_TR实时维护时/分/秒日期寄存器RTC_DR独立记录年月日同步机制硬件自动处理跨天更新而F103的简化设计埋下了隐患特性STM32F103STM32F4时间基准32位计数器CNT独立TR/DR寄存器日期存储软件维护硬件自动更新掉电保持仅CNT保持全寄存器保持跨天处理需软件干预硬件自动处理这种差异导致当F103的CNT计数器累计超过24小时后HAL库的HAL_RTC_GetDate()会出现逻辑混乱。更棘手的是CubeMX生成的初始化代码会无意中加剧这个问题——每次上电都重置日期寄存器。关键发现F103的RTC实际上只是个带日历功能的计数器所有日期计算都依赖软件实现2. 问题复现与根因分析在STM32CubeIDE环境下用以下代码可以稳定复现该问题// 设置初始时间23:59:55 RTC_TimeTypeDef sTime {0}; sTime.Hours 23; sTime.Minutes 59; sTime.Seconds 55; HAL_RTC_SetTime(hrtc, sTime, RTC_FORMAT_BIN); // 设置初始日期2023-05-15 RTC_DateTypeDef sDate {0}; sDate.Year 23; sDate.Month 5; sDate.Date 15; HAL_RTC_SetDate(hrtc, sDate, RTC_FORMAT_BIN); // 模拟5秒后跨天 while(1) { HAL_RTC_GetTime(hrtc, sTime, RTC_FORMAT_BIN); HAL_RTC_GetDate(hrtc, sDate, RTC_FORMAT_BIN); printf(Date: 20%02d-%02d-%02d\n, sDate.Year, sDate.Month, sDate.Date); HAL_Delay(1000); }问题现象当时钟从23:59:59过渡到00:00:00时输出日期会突然跳变为2000-01-01。根因定位跟踪HAL库源码发现问题出在stm32f1xx_hal_rtc.c的这两个关键函数HAL_RTC_GetTime()中处理跨天的逻辑// 原始问题代码 if (hours 24U) { days_elapsed (hours / 24U); sTime-Hours (hours % 24U); counter_time - (days_elapsed * 24U * 3600U); // 错误根源 RTC_WriteTimeCounter(hrtc, counter_time); }HAL_RTC_SetDate()中的日期重置逻辑if (hours 24U) { counter_time - ((hours / 24U) * 24U * 3600U); RTC_WriteTimeCounter(hrtc, counter_time); }这两处代码都在跨天时修改了CNT计数器的值但却没有同步更新日期寄存器导致软件维护的日期信息与实际时间脱节。3. 解决方案一HAL库函数修改法对于需要长期维护的项目直接修改HAL库是最彻底的解决方案。以下是具体实施步骤3.1 修改GetTime函数在HAL_RTC_GetTime()中注释掉计数器重写逻辑// 修改后代码 if (hours 24U) { days_elapsed (hours / 24U); sTime-Hours (hours % 24U); // counter_time - (days_elapsed * 24U * 3600U); // 注释此行 // RTC_WriteTimeCounter(hrtc, counter_time); // 注释此行 }3.2 增强SetDate函数在HAL_RTC_SetDate()中添加日期备份机制HAL_StatusTypeDef HAL_RTC_SetDate(RTC_HandleTypeDef *hrtc, RTC_DateTypeDef *sDate, uint32_t Format) { /* 原有代码... */ // 新增备份寄存器写入 HAL_RTCEx_BKUPWrite(hrtc, RTC_BKP_DR2, sDate-Year); HAL_RTCEx_BKUPWrite(hrtc, RTC_BKP_DR3, sDate-Month); HAL_RTCEx_BKUPWrite(hrtc, RTC_BKP_DR4, sDate-Date); /* 原有代码... */ }3.3 实现日期更新函数添加自定义的日期计算函数void UpdateRtcDate(RTC_HandleTypeDef *hrtc, uint32_t days_elapsed) { RTC_DateTypeDef sDate {0}; // 从备份寄存器读取基准日期 sDate.Year HAL_RTCEx_BKUPRead(hrtc, RTC_BKP_DR2); sDate.Month HAL_RTCEx_BKUPRead(hrtc, RTC_BKP_DR3); sDate.Date HAL_RTCEx_BKUPRead(hrtc, RTC_BKP_DR4); // 简单日期计算实际项目需考虑闰年等复杂情况 sDate.Date days_elapsed; while (sDate.Date 31) { sDate.Date - 31; sDate.Month; if (sDate.Month 12) { sDate.Month 1; sDate.Year; } } HAL_RTC_SetDate(hrtc, sDate, RTC_FORMAT_BIN); }注意事项修改后的HAL库文件需要单独备份CubeMX重新生成代码时会覆盖这些修改4. 解决方案二备份寄存器方案对于不想修改HAL库的项目可以利用F103的备份寄存器RTC_BKPxDR构建解决方案4.1 初始化流程优化void MX_RTC_Init(void) { /* 检查备份寄存器标志 */ if (HAL_RTCEx_BKUPRead(hrtc, RTC_BKP_DR1) ! 0x55AA) { // 首次初始化 RTC_TimeTypeDef sTime {0}; RTC_DateTypeDef sDate {0}; // 设置默认时间 sTime.Hours 0; sTime.Minutes 0; sTime.Seconds 0; HAL_RTC_SetTime(hrtc, sTime, RTC_FORMAT_BIN); // 设置默认日期 sDate.Year 23; sDate.Month 1; sDate.Date 1; HAL_RTC_SetDate(hrtc, sDate, RTC_FORMAT_BIN); // 写入备份寄存器 HAL_RTCEx_BKUPWrite(hrtc, RTC_BKP_DR1, 0x55AA); HAL_RTCEx_BKUPWrite(hrtc, RTC_BKP_DR2, sDate.Year); HAL_RTCEx_BKUPWrite(hrtc, RTC_BKP_DR3, sDate.Month); HAL_RTCEx_BKUPWrite(hrtc, RTC_BKP_DR4, sDate.Date); } else { // 恢复日期 RTC_DateTypeDef sDate {0}; sDate.Year HAL_RTCEx_BKUPRead(hrtc, RTC_BKP_DR2); sDate.Month HAL_RTCEx_BKUPRead(hrtc, RTC_BKP_DR3); sDate.Date HAL_RTCEx_BKUPRead(hrtc, RTC_BKP_DR4); HAL_RTC_SetDate(hrtc, sDate, RTC_FORMAT_BIN); } }4.2 日期同步守护任务在FreeRTOS中创建低优先级任务或裸机环境下使用定时器void vRTCDateKeeper(void *pvParameters) { TickType_t xLastWakeTime xTaskGetTickCount(); RTC_TimeTypeDef sLastTime {0}; HAL_RTC_GetTime(hrtc, sLastTime, RTC_FORMAT_BIN); for(;;) { vTaskDelayUntil(xLastWakeTime, pdMS_TO_TICKS(1000)); RTC_TimeTypeDef sCurrentTime {0}; HAL_RTC_GetTime(hrtc, sCurrentTime, RTC_FORMAT_BIN); // 检测跨天 if (sCurrentTime.Hours sLastTime.Hours) { RTC_DateTypeDef sDate {0}; HAL_RTC_GetDate(hrtc, sDate, RTC_FORMAT_BIN); sDate.Date 1; // 处理月份/年份进位... HAL_RTC_SetDate(hrtc, sDate, RTC_FORMAT_BIN); // 更新备份寄存器 HAL_RTCEx_BKUPWrite(hrtc, RTC_BKP_DR2, sDate.Year); HAL_RTCEx_BKUPWrite(hrtc, RTC_BKP_DR3, sDate.Month); HAL_RTCEx_BKUPWrite(hrtc, RTC_BKP_DR4, sDate.Date); } sLastTime sCurrentTime; } }5. 方案对比与选择建议两种方案各有优劣具体选择取决于项目需求评估维度HAL库修改方案备份寄存器方案侵入性高需修改库文件低应用层实现维护成本高CubeMX更新需重新应用低精度高自动处理中依赖任务调度资源占用低中需额外任务/定时器跨平台兼容性低F1专用高可移植到其他系列在三个量产项目中我们最终选择了混合方案使用备份寄存器维护日期基准同时在应用层添加日期同步逻辑。这种组合既避免了HAL库修改带来的维护负担又保证了日期更新的可靠性。