1 RA6E2 RTC簡介

RA6E2的RTC(Real Time Clock)外設(shè)，實質(zhì)是一個掉電后還繼續(xù)運行的定時器。從定時器的角度來說，相對于GPT外設(shè)，要簡單很多 ，只有計時和觸發(fā)中斷以及輸入捕獲的功能。RTC外設(shè)的特別之處并不在于它的定時功能，而在于它掉電還繼續(xù)運行的特性。

2 RT-Thread 的RTC簡介

RTC （Real-Time Clock）實時時鐘可以提供精確的實時時間，它可以用于產(chǎn)生年、月、日、時、分、秒等信息。目前實時時鐘芯片大多采用精度較高的晶體振蕩器作為時鐘源。有些時鐘芯片為了在主電源掉電時還可以工作，會外加電池供電，使時間信息一直保持有效。

在開啟 RTC 設(shè)備框架以及 RTC 驅(qū)動之后，應(yīng)用程序通過 RT-Thread 提供的 RTC設(shè)備管理接口來訪問 RTC 硬件，相關(guān)接口如下所示：

另外，alarm 鬧鐘功能是基于 RTC 設(shè)備實現(xiàn)的，根據(jù)用戶設(shè)定的鬧鐘時間，當(dāng)時間到時觸發(fā) alarm 中斷，執(zhí)行鬧鐘事件。

alarm 組件提供的接口如下所示：

https://www.rt-thread.org/document/site/#/rt-thread-version/rt-thread-standard/programming-manual/device/rtc/rtc

3 RTC實例

3.1 RA6E2 RTC配置

接下來配置RTC，只需要簡單配置就可使用。

• FSP配置RTC

1.添加 RTC 設(shè)備

2.配置 RTC

RT-Thread 中只是用了一個 RTC 設(shè)備，所以沒有對其進(jìn)行編號，如果是新創(chuàng)建的 RTC 設(shè)備需要注意 name 字段，在驅(qū)動中默認(rèn)使用的是g_rtc，不然編譯會提示沒有相應(yīng)的設(shè)備，修改 Callback 為 rtc_callback。

• 配置RTC和alarm組件

然后打開對應(yīng)的通道

同時打開alarm組件。

3.2 RTC代碼實現(xiàn)

首先設(shè)置了年月日時分秒信息，然后獲取當(dāng)前時間，接著設(shè)置一個alarm，值得注意的是，alarm是基于RTC的，因此需要先將RTC初始化，然后才能開啟alarm事件。核心代碼如下：

#include < rtthread.h >
#include < rtdevice.h >
#include < time.h >

#define DBG_LEVEL DBG_LOG
#define DBG_SECTION_NAME "rtc"
#include < rtdbg.h >

#define RTC_NAME "rtc"

rt_sem_t rtc_init_sem = RT_NULL;

static int uesr_rtc_init(void)
{
    rt_err_t ret = RT_EOK;
    time_t now;
    rt_device_t device = RT_NULL;

    /*創(chuàng)建初始化完成信號量*/
    rtc_init_sem = rt_sem_create("rtc init flag", 0, 0);
    if(rtc_init_sem == RT_NULL)
    {
        rt_kprintf("rtc sem init failed!");
        return RT_ERROR;
    }
    /*尋找設(shè)備*/
    device = rt_device_find(RTC_NAME);
    if (!device)
    {
        rt_kprintf("find %s failed!", RTC_NAME);
        return RT_ERROR;
    }
    /*初始化RTC設(shè)備*/
    if(rt_device_open(device, 0) != RT_EOK)
    {
        rt_kprintf("open %s failed!", RTC_NAME);
        return RT_ERROR;
    }
    /* 設(shè)置日期 */
    ret = set_date(2023, 06, 21);
    if (ret != RT_EOK)
    {
        rt_kprintf("set RTC date failedn");
        return ret;
    }

    /* 設(shè)置時間 */
    ret = set_time(20, 57, 50);
    if (ret != RT_EOK)
    {
        rt_kprintf("set RTC time failedn");
        return ret;
    }

    rt_sem_release(rtc_init_sem);
    /* 獲取時間 */
    now = time(RT_NULL);
    rt_kprintf("RTC device init success,now time is %sn", ctime(&now));

    return ret;
}

/*作為用戶APP初始化*/
INIT_APP_EXPORT(uesr_rtc_init);

static time_t now;

void user_alarm_callback(rt_alarm_t alarm, time_t timestamp)
{
    now = time(RT_NULL);
    rt_kprintf("The alarm clock rings, now time is %sn", ctime(&now));
    rt_alarm_stop(alarm);
}

void alarm_test(void)
{
    if(rt_sem_trytake(rtc_init_sem) != RT_EOK)
    {
        rt_kprintf("please init rtc first");
        return ;
    }
    struct rt_alarm_setup setup;
    struct rt_alarm * alarm = RT_NULL;
    static time_t now;
    struct tm p_tm;

    if (alarm != RT_NULL)
        return;

    /*獲取當(dāng)前時間戳，并把下一秒時間設(shè)置為鬧鐘時間 */
    now = time(NULL) + 5;
    gmtime_r(&now,&p_tm);

    setup.flag = RT_ALARM_SECOND;
    setup.wktime.tm_year = p_tm.tm_year;
    setup.wktime.tm_mon = p_tm.tm_mon;
    setup.wktime.tm_mday = p_tm.tm_mday;
    setup.wktime.tm_wday = p_tm.tm_wday;
    setup.wktime.tm_hour = p_tm.tm_hour;
    setup.wktime.tm_min = p_tm.tm_min;
    setup.wktime.tm_sec = p_tm.tm_sec;
    alarm = rt_alarm_create(user_alarm_callback, &setup);
    if(RT_NULL != alarm)
    {
        rt_alarm_start(alarm);
    }
}

/*export msh cmd*/
MSH_CMD_EXPORT(alarm_test,a alarm test);

3.3 測試驗證

編譯下載，調(diào)試信息如下：

從以上打印信息可以看出，rtc已經(jīng)使能，然后使用MSH命令‘a(chǎn)larm_test’即可使能RTC線程，并且執(zhí)行相應(yīng)的事件。