二十八、立创·梁山派天空星开发板RTC实时时钟配置与断电走时实战

二十八、立创·梁山派天空星开发板RTC实时时钟配置与断电走时实战很多朋友在用单片机做项目时都遇到过需要记录时间的情况比如数据采集要打上时间戳或者设备需要定时自动开关机。这时候一个靠谱的实时时钟RTC就非常重要了。今天咱们就以立创·梁山派天空星开发板GD32F4系列为例手把手教你配置RTC并实现一个核心功能即使主电源断电时钟也能靠后备电池继续走时。我会把整个流程拆解得明明白白从原理到代码再到实际调试中可能遇到的坑都会讲到。哪怕你是刚接触嵌入式的新手跟着做下来也能搞定。注意要实现断电后时钟还能走你的开发板必须焊接好电池座并装上纽扣电池比如CR1220。高低配版的天空星开发板出厂时电池座是没焊接的需要你自己动手焊上。这是硬件前提别忘了1. RTC是什么为什么需要它你可能用过单片机里的普通定时器来做延时但那个定时器一旦单片机断电重启计数值就清零了。RTCReal-Time Clock则不同它是一个独立的“电子手表”模块。它的核心特点有两个持续计时只要后备电池VBAT引脚供电有电就算主电源VDD拔掉RTC也能一直走时间不会丢。日历功能能直接提供年、月、日、星期、时、分、秒不用你自己去算。在天空星开发板上RTC模块的时钟源我们选择板载的32.768kHz晶振。这个频率很特殊经过15次分频2的15次方正好是1秒所以计时非常精准而且功耗很低特别适合用电池供电的场景。整个配置流程我们可以概括为下面四个关键步骤后面会逐一展开讲解解锁备份域拿到修改RTC核心设置的“钥匙”。选择时钟源告诉RTC用哪个“心跳”来计时这里选外部32.768kHz晶振。开启RTC外设给这个“电子手表”通上电让它准备好。初始化日历给手表对时设置初始的年月日时分秒。2. 第一步解锁备份域的写保护RTC的核心配置寄存器位于一个叫“备份域”的特殊区域。单片机设计时为了安全防止程序跑飞意外修改了时间给这个区域加了一把“锁”。我们配置的第一步就是开锁。// 1. 使能电源管理单元PMU的时钟 rcu_periph_clock_enable(RCU_PMU); // 2. 启用对备份域寄存器的写访问权限 pmu_backup_write_enable();代码解读RCU_PMUPMU电源管理单元是管理备份域的老大操作备份域前必须先打开它的时钟。pmu_backup_write_enable()这个函数就是“开锁”的动作。执行后我们才能修改RTC相关的配置寄存器。3. 第二步选择并启动外部低速时钟源时钟源是RTC的“心脏”。GD32的RTC有三种心跳来源可选时钟源特点是否支持断电走时功耗内部低速IRC32K芯片内部自带无需外接不支持VDD断电即停低外部低速LXTAL (32.768kHz)需要外接晶振支持依靠VBAT电池很低外部高速HXTAL (2-31MHz)需要外接高速晶振支持高我们的目标是低功耗断电走时所以最佳选择就是外部低速32.768kHz晶振。幸运的是天空星开发板上已经焊好了这个晶振青春版用户请注意下面的提示。// 1. 开启外部低速晶振LXTAL振荡器 rcu_osci_on(RCU_LXTAL); // 2. 等待晶振起振并稳定下来 rcu_osci_stab_wait(RCU_LXTAL); // 3. 将RTC的时钟源配置为刚才启动的LXTAL rcu_rtc_clock_config(RCU_RTCSRC_LXTAL);重要提示给青春版用户立创·梁山派天空星开发板的青春版为了控制成本板载的32.768kHz晶振位置是空的如果你直接使用上面的代码程序会卡在rcu_osci_stab_wait这里因为永远等不到晶振起振。解决方案要么自己买一个32.768kHz晶振型号通常为MC-306焊上去要么在软件上改用其他时钟源如内部IRC32K但就无法断电走时了。4. 第三步开启RTC外设并等待同步选好了心跳接下来就要唤醒RTC这个“手表”本身了。// 1. 使能RTC外设的时钟 rcu_periph_clock_enable(RCU_RTC); // 2. 等待RTC寄存器同步 rtc_register_sync_wait();这里有个关键点RTC的时钟域和主系统时钟域是异步的。当你修改RTC的配置寄存器时需要等待两个时钟域同步之后设置才能生效。rtc_register_sync_wait()这个函数就是在干这个“等待”的活儿。这是一个必须的步骤少了它配置可能不成功。5. 第四步配置初始日历时间现在手表已经通电、心跳正常就差对时了。我们需要用一个结构体rtc_parameter_struct来设置时间。这里有个嵌入式里常见的编码格式需要了解BCD码。它是一种用4位二进制数来表示1位十进制数0-9的编码。比如十进制数23在BCD码里就是0x23十六进制表示。RTC模块内部存储时间用的就是BCD码所以我们的输入参数也必须是BCD格式。假设我们要设置时间为2023年12月1日星期五10点52分01秒。void RtcTimeConfig(uint8_t year, uint8_t month, uint8_t date, uint8_t week, uint8_t hour, uint8_t minute, uint8_t second) { rtc_parameter_struct rtc_initpara; // 设置预分频器这两个值决定了时钟源如何分频得到1秒的基准。 // 对于32.768kHz晶振通常异步分频(0x7F)和同步分频(0xFF)组合得到1秒。 rtc_initpara.factor_asyn 0x7F; // 异步预分频值范围0x0~0x7F rtc_initpara.factor_syn 0xFF; // 同步预分频值范围0x0~0x7FFF // 设置日期时间注意参数是BCD码 rtc_initpara.year year; // 0x23 表示 2023年 rtc_initpara.month month; // 0x12 表示 12月 rtc_initpara.date date; // 0x01 表示 1日 rtc_initpara.day_of_week week; // 0x05 表示星期五 (通常1周一...7周日需查手册确认) rtc_initpara.hour hour; // 0x10 表示 10点 rtc_initpara.minute minute; // 0x52 表示 52分 rtc_initpara.second second; // 0x01 表示 01秒 rtc_initpara.display_format RTC_24HOUR; // 使用24小时制 // 将以上配置初始化到RTC硬件 rtc_init(rtc_initpara); }调用这个函数时就需要传入BCD码RtcTimeConfig(0x23, 0x12, 0x01, 0x05, 0x10, 0x52, 0x01);6. 核心技巧实现“首次上电初始化”这里有一个实际项目中的经典问题我们每次单片机复位都调用RtcTimeConfig那时间不就被重置了吗怎么保证断电再上电后时间能接着走而不是回到初始值答案是利用备份寄存器。备份寄存器是备份域里的一小块存储区它的特点和RTC时间一样只要后备电池有电里面的数据就不会丢失。我们可以用它来做一个“标记”。思路如下单片机第一次上电时备份寄存器里是随机值我们假设它不是某个特定值比如0x1234。我们配置好RTC时间后同时向一个备份寄存器例如RTC_BKP0写入一个魔法数字比如0x1234。以后每次单片机上电复位都先检查这个备份寄存器的值。如果发现值是0x1234就说明RTC已经初始化过了并且一直在走时我们不应该再重新配置时间而是直接读取当前时间即可。如果值不是0x1234说明是第一次运行那就执行完整的RTC初始化和时间设置。我们把上面的逻辑整合到初始化函数里void bsp_rtc_init(void) { // 1. 解锁备份域 rcu_periph_clock_enable(RCU_PMU); pmu_backup_write_enable(); // 2. 选择并启动外部32.768kHz时钟源 rcu_osci_on(RCU_LXTAL); rcu_osci_stab_wait(RCU_LXTAL); rcu_rtc_clock_config(RCU_RTCSRC_LXTAL); // 3. 开启RTC并等待同步 rcu_periph_clock_enable(RCU_RTC); rtc_register_sync_wait(); // 4. 判断是否是第一次上电 if (RTC_BKP0 0x1234) { // 不是第一次RTC已在运行什么都不用做直接退出 // 此时RTC的时间就是真实的、持续走动的当前时间 } else { // 是第一次写入标记 RTC_BKP0 0x1234; // 然后初始化日历时间 RtcTimeConfig(0x23, 0x12, 0x01, 0x05, 0x10, 0x52, 0x01); } }这个bsp_rtc_init()函数就是最终版的、智能的RTC初始化函数。你只需要在main函数开始调用它一次它就自动处理好“首次配置”和“后续保持”的问题。7. 如何读取并显示时间配置好了时间也在走了我们怎么把它读出来用呢同样使用rtc_current_time_get函数它会将当前时间填充到一个结构体里。不过读出来的值仍然是BCD码为了方便查看我们通常要转换成十进制数。下面是一个转换函数和显示函数的例子// BCD码转十进制数的函数 int BcdToDecimal(int bcd) { int decimal 0; int temp 1; int number 0; while(bcd 0) { number bcd % 16; // 取出低4位一位BCD码 decimal number * temp; temp * 10; // 十进制位权重 bcd / 16; // 移除已处理的一位BCD码 } return decimal; } // 获取并打印当前RTC时间 void RtcShowTime(void) { rtc_parameter_struct rtc_initpara_time; // 获取RTC时间信息 rtc_current_time_get(rtc_initpara_time); // 转换并打印时间时:分:秒 printf(Current time: %d:%d:%d\r\n, BcdToDecimal(rtc_initpara_time.hour), BcdToDecimal(rtc_initpara_time.minute), BcdToDecimal(rtc_initpara_time.second)); // 转换并打印日期年-月-日 printf(Current date: %d-%d-%d\r\n, BcdToDecimal(rtc_initpara_time.year), BcdToDecimal(rtc_initpara_time.month), BcdToDecimal(rtc_initpara_time.date)); }8. 实战演练完整的工程代码把上面的所有部分组合起来创建一个rtc.h和rtc.c文件然后在主函数中调用。rtc.h 头文件#ifndef __RTC_H__ #define __RTC_H__ #include gd32f4xx.h void bsp_rtc_init(void); void RtcShowTime(void); void RtcTimeConfig(uint8_t year, uint8_t month, uint8_t date, uint8_t week, uint8_t hour, uint8_t minute, uint8_t second); #endif主函数 main.c#include board.h #include bsp_uart.h // 假设你的串口初始化在这里 #include rtc.h int main(void) { // 硬件初始化 board_init(); bsp_uart_init(); // 初始化串口用于打印时间 bsp_rtc_init(); // 初始化RTC智能判断是否首次运行 while (1) { // 每秒读取并打印一次RTC时间 RtcShowTime(); delay_ms(1000); } }实验现象将代码编译下载到天空星开发板并连接串口助手。上电后串口会每秒打印一次当前时间。如果你已经焊好电池并安装了纽扣电池现在可以尝试断开开发板的USB供电主电源等待十几秒后再重新上电。你会发现串口打印出的时间是从你断电的那一刻继续往后走的而不是回到代码里写的初始时间10:52:01。这就证明我们的“断电走时”功能成功实现了9. 调试心得与常见问题时间不走或不准首先检查32.768kHz晶振是否起振。可以用示波器测量晶振引脚。如果青春版没焊晶振程序会卡住。断电后时间重置检查电池确保纽扣电池有电且安装方向正确。检查电池座焊接确保电池座与板子的VBAT电路连通。检查代码确认使用了备份寄存器做首次上电判断if (RTC_BKP0 0x1234)逻辑。编译错误确保你的工程正确包含了GD32的标准外设库并且gd32f4xx.h等头文件路径设置正确。读取的时间值异常确认读取时间发生在RTC初始化完成之后。在bsp_rtc_init()函数执行完毕前不要调用RtcShowTime()。搞定RTC你的项目就拥有了“记忆时间”的能力。无论是做数据记录仪、智能闹钟还是需要定时任务的设备这个基础功能都非常有用。希望这篇教程能帮你扫清障碍成功在天空星开发板上跑通RTC。