【瑞萨RA MCU创意氛围赛】5. RTC实时时钟应用

hehung

# 前言

本文讲解如何使用启明RA6M5芯片内部RTC模块实现实时时钟。

RTC是实时时钟模块，设置了初始时间之后会自动累计时间，并且精度很高。

# 1 RASC 配置

配置如下，使能RTC的Realtime Clock Stack。



详细配置如下，可以不用配置回调函数，本例中实际没有使用到。



# 2 代码实现

代码实现如下：

初始化的时候调用 `Rtc_Init`即可，设定初始时间为：2023年7月15日12点三十分0秒。

然后每一秒钟调用一次 `Rtc_GetDateTime`。用来检测RTC累计时间是否正确。

1. /*
   
2. @hehung
   
3. 2023-2-8
   
4. 转载请注明出处，版权由@hehung所有
   
5. email: 1398660197@qq.com
   
6. wechat: hehung95
   
7. */
   
8. 
   
9. #include "hal_data.h"
   
10. #include "app_rtc.h"
    
11. 
    
12. 
    
13. #define RTC_DEBUG
    
14. #undef RTC_DEBUG
    
15. 
    
16. #ifdef RTC_DEBUG
    
17. #include <stdio.h>
    
18. #endif
    
19. 
    
20. #define RTC_ALARM_EN        (COMM_OFF)
    
21. 
    
22. 
    
23. /* rtc_time_t is an alias for the C Standard time.h struct 'tm' */
    
24. rtc_time_t set_time =
    
25. {
    
26.     .tm_sec  = 0,      /* 秒，范围从 0 到 59 */
    
27.     .tm_min  = 30,      /* 分，范围从 0 到 59 */
    
28.     .tm_hour = 12,      /* 小时，范围从 0 到 23*/
    
29.     .tm_mday = 19,       /* 一月中的第几天，范围从 1 到 31*/
    
30.     .tm_mon  = 1,      /* 月份，范围从 0 到 11*/
    
31.     .tm_year = 123,     /* 自 1900 起的年数，2021为121*/
    
32.     .tm_wday = 0,       /* 一周中的第几天，范围从 0 到 6*/
    
33. //    .tm_yday=0,         /* 一年中的第几天，范围从 0 到 365*/
    
34. //    .tm_isdst=0;        /* 夏令时*/
    
35. };
    
36. 
    
37. #if (RTC_ALARM_EN == COMM_ON)
    
38. rtc_alarm_time_t set_alarm_time=
    
39. {
    
40.      .time.tm_sec  =   5,
    
41.      .time.tm_sec  = 5,      /* 秒，范围从 0 到 59 */
    
42.      .time.tm_min  = 30,      /* 分，范围从 0 到 59 */
    
43.      .time.tm_hour = 12,      /* 小时，范围从 0 到 23*/
    
44.      .time.tm_mday = 20,       /* 一月中的第几天，范围从 1 到 31*/
    
45.      .time.tm_mon  = 11,      /* 月份，范围从 0 到 11*/
    
46.      .time.tm_year = 121,     /* 自 1900 起的年数，2021为121*/
    
47.      .time.tm_wday = 5,       /* 一周中的第几天，范围从 0 到 6*/
    
48. 
    
49.      .sec_match        =  1,
    
50.      .min_match        =  0,
    
51.      .hour_match       =  0,
    
52.      .mday_match       =  0,
    
53.      .mon_match        =  0,
    
54.      .year_match       =  0,
    
55.      .dayofweek_match  =  0,
    
56. };
    
57. #endif
    
58. 
    
59. // notification of rtc
    
60. void rtc_notification(rtc_callback_args_t *p_args)
    
61. {
    
62.     /* TODO: add your own code here */
    
63.     (void)p_args;
    
64.     // if(p_args->event == RTC_EVENT_PERIODIC_IRQ)
    
65.     //     rtc_flag=1;
    
66.     // else if(p_args->event == RTC_EVENT_ALARM_IRQ)
    
67.     //     rtc_alarm_flag=1;
    
68. }
    
69. 
    
70. 
    
71. void Rtc_Init(void)
    
72. {
    
73.     fsp_err_t err = FSP_SUCCESS;
    
74. 
    
75.     /* Initialize the RTC module*/
    
76.     err = R_RTC_Open(&g_rtc0_ctrl, &g_rtc0_cfg);
    
77.     /* Handle any errors. This function should be defined by the user. */
    
78.     assert(FSP_SUCCESS == err);
    
79.     /* R_RTC_CalendarTimeSet must be called at least once to start the RTC */
    
80.     R_RTC_CalendarTimeSet(&g_rtc0_ctrl, &set_time);
    
81.     /* Set the periodic interrupt rate to 1 second */
    
82.     R_RTC_PeriodicIrqRateSet(&g_rtc0_ctrl, RTC_PERIODIC_IRQ_SELECT_1_SECOND);
    
83. 
    
84. #if (RTC_ALARM_EN == COMM_ON)
    
85.     /* Set alarm time */
    
86.     R_RTC_CalendarAlarmSet(&g_rtc0_ctrl, &set_alarm_time);
    
87. #endif
    
88. }
    
89. 
    
90. // set date-time
    
91. void Rtc_SetDateTime(rtc_time_t * const p_time)
    
92. {
    
93.     R_RTC_CalendarTimeSet(&g_rtc0_ctrl, p_time);
    
94. }
    
95. 
    
96. // get date-time
    
97. rtc_time_t Rtc_GetDateTime(void)
    
98. {
    
99.     rtc_time_t get_time;
    
100. 
     
101.     // get rtc time
     
102.     (void)R_RTC_CalendarTimeGet(&g_rtc0_ctrl, &get_time);
     
103. 
     
104. #ifdef RTC_DEBUG
     
105.     printf("RTC: %d-%d-%d, %d:%d:%d, %dw\n", get_time.tm_year + 1900,
     
106.                                            get_time.tm_mon,
     
107.                                            get_time.tm_mday,
     
108.                                            get_time.tm_hour,
     
109.                                            get_time.tm_min,
     
110.                                            get_time.tm_sec,
     
111.                                            get_time.tm_wday);
     
112. #endif
     
113. 
     
114.     return get_time;
     
115. }
     

复制代码

# 3 试验效果

如下，串口打印的时候添加上时间戳功能，可以检测处打印的RTC反馈的时间是否正确，如下图所示，试验成功。