RTC：Real Time Clock，实时时钟。

准备工作

1 下载并安装e² studio工具

下载地址，推荐瑞萨官方的GitHub：https://github.com/renesas/fsp/releases

我们这里以瑞萨RA8D1单片机为例（当然，其实RA系列单片机也类似）：

1 创建工程

我们会用到串口打印输出，这里基于之前分享的UART串口工程进行拓展。这里说几个重要的地方，首先是UART串口时钟，需要选择SCICLK时钟：

再次，配置UART对应的信息：

还有设置，菜单：项目->C/C++Project Settings：

2 配置RTC模块

为了方便大家理解，我们先以最基础的方式配置RTC，然后，间隔1秒读一次RTC并通过UART串口打印输出。

配置RTC：Pins选项下，选择RTC，配置模式。

新建RTC模块：我们添加RTC模块并配置相关属性（配置常用参数，其实默认即可）

3 添加源代码

我们这里简单添加一个RTC模块（源代码文件），如图：

bsp_rtct.c源代码：

#include "bsp_rtc.h"
void RTC_Init(void)
{
   //设置初始化日期和时间
   rtc_time_t set_time =
   { .tm_sec = RTC_SEC_SET,  //秒
     .tm_min = RTC_MIN_SET,  //分
     .tm_hour = RTC_HOUR_SET,  //小时
     .tm_mday = RTC_MDAY_SET,  //日（一个月中）
     .tm_wday = RTC_WDAY_SET,   //星期
     .tm_mon = RTC_MON_SET - 1 ,   //月份
     .tm_year = RTC_YEAR_SET-1900, //年份
   }; 
  /*打开RTC*/
   R_RTC_Open (g_rtc.p_ctrl, g_rtc.p_cfg);
   /*设置时钟源*/
   R_RTC_ClockSourceSet (g_rtc.p_ctrl);
   /* 设置日期时间 */ 
  R_RTC_CalendarTimeSet (g_rtc.p_ctrl, &set_time);
}

bsp_rtc.h头代码：

#ifndef BSP_RTC_H#define BSP_RTC_H
#include "hal_data.h"
/**********日期宏定义**********/
#define RTC_YEAR_SET 2024       //年
#define RTC_MON_SET 10           //月
#define RTC_MDAY_SET 31          //日
/*换算星期*/
#define RTC_WDAY_SET (RTC_YEAR_SET-2000 \
                  + ((RTC_YEAR_SET-2000)/4) \
                  - 35 + (26*(RTC_MON_SET+1))/10 \
                  + RTC_MDAY_SET -1 )%7

/**********时间宏定义**********/
#define RTC_HOUR_SET 23          //时
#define RTC_MIN_SET 59           //分
#define RTC_SEC_SET 50           //秒
void RTC_Init(void);
#endif

这里我们只简单的配置（初始化）了日期和时间，然后在应用程序中，间隔1秒读取并打印输出。

void hal_entry(void)
{
    static rtc_time_t get_time;
    Debug_UART3_Init(); // SCI3 UART 调试串口初始化
    RTC_Init();         //初始化RTC
    while(1)
    {
        R_IOPORT_PinWrite(&g_ioport_ctrl, BSP_IO_PORT_10_PIN_01, BSP_IO_LEVEL_LOW);
        R_BSP_SoftwareDelay(500, BSP_DELAY_UNITS_MILLISECONDS); // 延时500ms
        R_IOPORT_PinWrite(&g_ioport_ctrl, BSP_IO_PORT_10_PIN_01, BSP_IO_LEVEL_HIGH);
        R_BSP_SoftwareDelay(500, BSP_DELAY_UNITS_MILLISECONDS); // 延时500ms

        /*获取当前时间*/
       R_RTC_CalendarTimeGet (g_rtc.p_ctrl, &get_time);
       /*打印当前时间*/
       printf("RTC:%d-%d-%d-%d:%d:%d\r\n", get_time.tm_year + 1900, get_time.tm_mon + 1, get_time.tm_mday,                get_time.tm_hour, get_time.tm_min, get_time.tm_sec);
    }
}

4 演示效果

这里通过间隔1秒主动读取RTC，并打印输出显示，最后效果：

然后在代码中增加 rtc_callback 这个中断回调函数。

void rtc_callback(rtc_callback_args_t *p_args)
{
      static rtc_time_t get_time;
      switch (p_args->event)
      {
         /*若是周期中断，则打印日期时间*/
         case RTC_EVENT_PERIODIC_IRQ:
            /*获取当前时间*/
            R_RTC_CalendarTimeGet (g_rtc.p_ctrl, &get_time);
            /*打印当前时间*/
            printf("RTC:%d-%d-%d-%d:%d:%d\r\n", get_time.tm_year + 1900, get_time.tm_mon + 1, get_time.tm_mday,                get_time.tm_hour, get_time.tm_min, get_time.tm_sec);
            break;
         default:
            break;
      }
}