ARMmbed/mbed-os中STM32U5系列RTC时钟初始化问题分析

问题背景

在ARMmbed/mbed-os嵌入式开发框架中，使用STM32U575xG系列MCU的开发人员遇到了一个实时时钟(RTC)功能异常的问题。具体表现为：当调用标准C库函数time(NULL)获取当前时间时，每次MCU复位后时间都会从12:00:00开始重新计数，而不是保持实际的RTC计时值。

问题现象

开发人员使用以下典型代码获取并显示当前时间：

int main()
{
    while(1) {
        time_t seconds = time(NULL);
        char buffer[32];
        strftime(buffer, 32, "%I:%M:%S %p", localtime(&seconds));
        printf("%s             \r", buffer);
        int i = 100000;
        while(i--); // 简单延时
    }
}

这段代码在每次MCU复位后都会从午夜12点开始计时，而不是继续之前的RTC计时值，这表明RTC模块没有正确保持其状态。

根本原因分析

经过深入调查，发现问题出在RTC相关时钟的初始化流程上。在STM32U5系列MCU中，除了常规的RTC时钟使能外，还需要额外使能两个APB时钟：

1. RTCAPB时钟
2. RTCAPB时钟AM(可能指低功耗模式下的时钟)

在CubeIDE生成的代码中，可以清楚地看到完整的初始化序列：

__HAL_RCC_RTC_ENABLE();
__HAL_RCC_RTCAPB_CLK_ENABLE();
__HAL_RCC_RTCAPB_CLKAM_ENABLE();

然而在mbed-os的默认实现中，只包含了基础的RTC时钟使能，缺少了对RTCAPB相关时钟的使能配置，导致RTC模块不能完全正常工作。

解决方案

有两种可行的解决方法：

1. 修改mbed_sdk_init()函数：在mbed_overrides.c文件中，位于DEVICE_RTC条件编译块内添加RTCAPB时钟使能代码：

#if defined __HAL_RCC_RTCAPB_CLK_ENABLE
    __HAL_RCC_RTCAPB_CLK_ENABLE();
#endif

2. 在main()函数前显式初始化RTC：在应用程序开始前调用rtc_init()函数。

第一种方法是更彻底的解决方案，因为它修复了框架层面的初始化缺陷，确保所有使用该平台的应用程序都能正确工作。

技术影响

这个问题特别影响STM32U5系列MCU，包括但不限于STM32U575xG型号。该问题可能导致：

1. 时间戳功能失效
2. 定时任务调度异常
3. 与时间相关的安全机制失效
4. 日志记录时间信息不准确

最佳实践建议

对于使用STM32U5系列MCU的开发者，建议：

1. 检查项目中是否依赖RTC功能
2. 如果使用自定义目标配置，确保包含必要的时钟初始化代码
3. 在关键时间应用中增加RTC状态验证机制
4. 考虑备份域寄存器的配置，确保RTC数据在低功耗模式下也能保持

总结

这个案例展示了在嵌入式开发中，硬件初始化完整性的重要性。即使是微小的时钟配置遗漏，也可能导致关键功能异常。对于使用ARMmbed/mbed-os框架的STM32U5系列开发者，应当特别注意RTC模块的完整初始化流程，确保所有相关时钟域都得到正确配置。