RT-Thread-【NuMaker-M2354试用】RTC实验RT-Thread问答社区

【NuMaker-M2354试用】RTC实验

发布于 2021-12-19 19:13:08 浏览：690 订阅该版

[tocm]

### 【NuMaker-M2354试用】RTC实验

#### 1.测评任务

测试M2354的硬件RTC，开启RTC功能，运用RT-Thread提供的bsp及库函数，实现一个RTC功能。

实现功能：初始化RTC时间，通过控制台每秒打印一次时间。

#### 2.测评硬件

本次使用的硬件是Nuvoton官方的NuMaker-M2354开发板

mcu型号：M2354KJFAE

内核：cortex-M23

![01_hardware.jpg](https://oss-club.rt-thread.org/uploads/20211219/ed649bff904b60ea2c7c19b3fd7eccf1.jpg.webp)

#### 3.环境搭建及工程创建

资源下载

rt-thread master	https://gitee.com/rtthread/rt-thread/tree/master/

env	https://www.rt-thread.org/

驱动、官方资料等	https://www.nuvoton.com.cn/board/numaker-m2354/?index=0

M2354 bsp下载	https://gitee.com/OpenNuvoton/m2354bsp

环境搭建及软件安装具体可看坛友文章：https://club.rt-thread.org/ask/article/3168.html

刚下载下来的bsp工程包含了太多的rt-thread的组件，所以需要对工程仅从裁剪。裁剪通过env工具进入menuconfig菜单栏进行，最终会修改rtconfig.h这个配置文件。

创建的基础工程下载地址：https://gitee.com/sixer111111/m2354_rtt_base.git

工程结构如下，稍微简洁美观了一些。

![02_prj.jpg](https://oss-club.rt-thread.org/uploads/20211219/d75d357ed9b160d285ef4c52f3032a31.jpg.webp)

#### 4.主要函数调用

```c
//设置日期，年、月、日
rt_err_t set_date(rt_uint32_t year, rt_uint32_t month, rt_uint32_t day) 	
//设置时间，时、分、秒
rt_err_t set_time(rt_uint32_t hour, rt_uint32_t minute, rt_uint32_t second)
//获取当前时间
time_t time(time_t *t)
```

#### 5.代码

```c
//rtc_sample.c
#include <rtthread.h>
#include <rtdevice.h>

//线程配置
#define RTC_THREAD_PRIORITY		20
#define RTC_THREAD_STACK_SIZE	512
#define RTC_THREAD_TIMESLICE	5

rt_thread_t rtc_thread;

void rtc_thread_entry(void* p)
{
	time_t now;
	
	//循环打印时间
    while(1)
    {
        rt_thread_mdelay(500);
		now = time(RT_NULL);
		rt_kprintf("%s\n", ctime(&now));
		rt_thread_mdelay(500);
    }
}

int rtc_sample(void)
{
	rt_err_t ret = RT_EOK;
	
	//设置日期和时间
    rt_kprintf("[RTC Test]RTC Test Start...\n");
    rt_kprintf("[RTC Test]Set RTC 2017-04-01 12:30:46\n");
    ret = set_date(2021, 12, 19);
    if(ret != RT_EOK)
    {
        rt_kprintf("[RTC Test]Set RTC Date failed\n");
        return RT_ERROR;
    }
    ret = set_time(19, 02, 46);
    if(ret != RT_EOK)
    {
        rt_kprintf("[RTC Test]Set RTC Time failed\n");
        return RT_ERROR;
    }
	
	//创建rtc时间打印线程
	rtc_thread = rt_thread_create("rtc_thread",
                           rtc_thread_entry, RT_NULL,
                           RTC_THREAD_STACK_SIZE,
                           RTC_THREAD_PRIORITY,
                           RTC_THREAD_TIMESLICE);
	if(rtc_thread != RT_NULL)
	{
		rt_thread_startup(rtc_thread);
	}
	
	return 0;
}

MSH_CMD_EXPORT(rtc_sample, thread sample);

```

```c
//main.c没有做改变
/**************************************************************************//**
*
* @copyright (C) 2019 Nuvoton Technology Corp. All rights reserved.
*
* SPDX-License-Identifier: Apache-2.0
*
* Change Logs:
* Date            Author       Notes
* 2020-8-26       Wayne        First version
*
******************************************************************************/

#include <rtconfig.h>
#include <rtdevice.h>
#include <drv_gpio.h>

/* defined the LEDR pin: PD3 */
#define LEDR   NU_GET_PININDEX(NU_PD, 3)

int main(int argc, char **argv)
{
#if defined(RT_USING_PIN)
    int counter = 100;
    /* set LEDR pin mode to output */
    rt_pin_mode(LEDR, PIN_MODE_OUTPUT);

while (counter--)
    {
        rt_pin_write(LEDR, PIN_HIGH);
        rt_thread_mdelay(500);
        rt_pin_write(LEDR, PIN_LOW);
        rt_thread_mdelay(500);
    }
#endif
    return 0;
}

```

#### 6.编译运行

```shell
 \ | /
- RT -     Thread Operating System
 / | \     4.0.4 build Dec 19 2021 11:47:06
 2006 - 2021 Copyright by rt-thread team
msh >rtc_sample
[RTC Test]RTC Test Start...
[RTC Test]Set RTC 2017-04-01 12:30:46
msh >Sun Dec 19 19:02:46 2021
Sun Dec 19 19:02:47 2021
Sun Dec 19 19:02:48 2021
Sun Dec 19 19:02:49 2021
Sun Dec 19 19:02:50 2021
Sun Dec 19 19:02:51 2021
```

#### 7.实验现象

led闪烁，串口控制台里输入mesh指令 `rtc_sample` ，每隔1秒打印出日期时间。实验正常。

#### 8.测评代码

基础工程中新建 rtc_sample.c 文件，放入文章中的代码即可编译下载运行。

#### 9.测评文章

#### 10.测评心得

RTT master通过 BSP 把一切都封装好了，给用户提供了简洁易用的 API，真的非常方便，而且env工具也简单易用。但是配置修改起来对新手可能特别麻烦，希望有一个专门讲解 rtt master 工程结构以及相关配置功能讲解的资料可以学习。