RT-Thread-NXP MCXN947测评之 rtcRT-Thread问答社区

NXP MCXN947测评之 rtc

发布于 2024-03-24 11:16:30 浏览：304 订阅该版

[tocm]

# 1、前言说明
## 1.1 本章内容
本章通过env环境配置 FRDM-MCXN947的RTC设备 ，并对RTC的使用进行演示并测试。
## 1.2 模块介绍
实时时钟(RTC)是一个低功耗模块，提供时间保持和日历功能，还可以针对振荡器中由于晶体或温度引起的32kHz或16kHz时钟的变化来补偿1Hz时钟。

![微信截图_20240324103614.png](https://oss-club.rt-thread.org/uploads/20240324/568dd8444dc842e6e5830a652b4d4c4d.png.webp)
MCXN947 RTC包括以下功能：
- 专为低功耗设计
 - 时间和日期计数器交错排列，以防止同时切换
- 基本时钟功能
 - 天、小时、分钟和秒的独立计数器
 - 日历支持--独立的年、月和星期几计数器
   - 使用用户定义的参数自动调整夏令时
   - 自动调整月份和闰年
 - 如果您选择提供外部补偿的1Hz时钟，则支持运行计数器的外部时钟
- 时区偏移量——RTC使用本地时间，该时间隐含地包含时区偏移量
- 带中断的可编程报警——如果MCU将其用作唤醒事件，则从RTC输出报警
- 周期性中断（采样定时器中断）
- 硬件补偿——针对温度变化或晶体特性导致的振荡器时钟频率变化，补偿1 Hz时钟（到计数器）。通过固件计算的可编程校正系数。
- 16位CPU寄存器编程接口，可防止失控代码
- 可选择输出缓冲的32.768或16.384 kHz时钟或补偿的1 Hz时钟。

## 1.3.软件开发
开发环境：MDK 5.38，env 1.5.0

在开启 RTC 设备框架以及 RTC 驱动之后，用户可以`#include <sys/time.h>`用来引用标准的时间操作函数（例如 time、ctime、stime、mktime等）。在Unix系统或者Windows系统下怎么使用`<time.h>`里边的函数。

RTC 设备框架也提供了`set_date()`和`set_time()`函数，方便用户快速修改时间和日期。

|  函数 |  描述 |
| :------------: | :------------: |
|  set_date()  | 设置日期，年、月、日（当地时区） |
|  set_time()  | 设置时间，时、分、秒（当地时区） |
# 2.步骤说明
## 2.1.新建工程
下拉代码`git clone https://github.com/RT-Thread/rt-thread.git rt-thread`
切换到frdm-mcxn947工程目录`rt-thread\bsp\nxp\mcx\mcxn\frdm-mcxn947`
在env环境下右键单击鼠标，选择`ConEmu Here`
输入`scons --target=mdk5`后按回车重新生成工程
## 2.2配置RTC
env环境中输入`menuconfig`后按回车，弹出当前工程的配置界面
使能RTC模块`Hardware Drivers Config ---> On-chip Peripheral Drivers ---> Enable RTC`
![微信截图_20240324110141.png](https://oss-club.rt-thread.org/uploads/20240324/634ae405950dfc40d84e63f93afaeab3.png.webp)
保存设置
输入`scons --target=mdk5`后按回车重新生成工程
# 3、代码验证
## 3.1测试代码
编写测试代码，首先初始化RTC设备，然后设置日期时间，延时3秒后获取时间并打印。
```c
#include <rtthread.h>
#include <rtdevice.h>

#define RTC_NAME       "rtc"

static int rtc_test(int argc, char *argv[])
{
    rt_err_t ret = RT_EOK;
    time_t now;
    rt_device_t device = RT_NULL;

/*寻找设备*/
    device = rt_device_find(RTC_NAME);
    if (!device)
    {
      return RT_ERROR;
    }

/*初始化RTC设备*/
    if(rt_device_open(device, 0) != RT_EOK)
    {
      return RT_ERROR;
    }

/* 设置日期 */
    ret = set_date(2024, 3, 24);
    if (ret != RT_EOK)
    {
        rt_kprintf("set RTC date failed\n");
        return ret;
    }

/* 设置时间 */
    ret = set_time(11, 10, 50);
    if (ret != RT_EOK)
    {
        rt_kprintf("set RTC time failed\n");
        return ret;
    }

/* 延时3秒 */
    rt_thread_mdelay(3000);

/* 获取时间 */
    now = time(RT_NULL);
    rt_kprintf("%s\n", ctime(&now));

return ret;
}
/* 导出到 msh 命令列表中 */
MSH_CMD_EXPORT(rtc_test, rtc test);
```
编译并下载
![微信截图_20240324111207.png](https://oss-club.rt-thread.org/uploads/20240324/fcbb222d71df6b5e4410859733c8886d.png.webp)

使用`rtc_test`测试代码
![微信截图_20240324111412.png](https://oss-club.rt-thread.org/uploads/20240324/fbee5f8ee47b62dfd19a421a4e1c358c.png)

从以上打印信息可以看出，rtc已经使能，然后使用`date`命令确认时间已正常写入。