背景知识
如果学习过 STM32 的话应该知道, STM32 内部有一个 RTC 外设模块,这个模块需要一个32.768KHz 的晶振,对这个 RTC 模块进行初始化就可以得到一个实时时钟。 I.MX6U 内部也有个 RTC 模块,但是不叫作“RTC”,而是叫做“SNVS”。
SNVS 直译过来就是安全的非易性存储, SNVS 里面主要是一些低功耗的外设,包括一个安全的实时计数器(RTC)、一个单调计数器(monotonic counter)和一些通用的寄存器,本文我们肯定只使用实时计数器(RTC)。SNVS 里面的外设在芯片掉电以后由电池供电继续运行, I.MX6UALPHA 开发板上有一个纽扣电池,这个纽扣电池就是在主电源关闭以后为 SNVS 供电的。
因为纽扣电池在掉电以后会继续给 SNVS 供电,因此实时计数器就会一直运行,这样的话时间信息就不会丢失,除非纽扣电池没电了。在有纽扣电池作为后备电源的情况下,不管系统主电源是否断电, SNVS 都正常运行。 SNVS 有两部分: SNVS_HP 和 SNVS_LP,系统主电源断电以后 SNVS_HP 也会断电,但是在后备电源支持下, SNVS_LP 是不会断电的,而且 SNVS_LP是和芯片复位隔离开的,因此 SNVS_LP 相关的寄存器的值会一直保存着。
寄存器 SNVS_LPSRTCMR 和 SNVS_LPSRTCLR 保存着秒数,直接读取这两个寄存器的值就知道过了多长时间了。一般以 1970 年 1 月 1 日为起点,加上经过的秒数即可得到现在的时间和日期,原理还是很简单的。
接下来我们看一下要用到的与 SRTC 相关的部分寄存器,首先是 SNVS_HPCOMR 寄存器,这个寄存器我们只用到了位: NPSWA_EN(bit31),这个位是非特权软件访问控制位,如果非特权软件要访问 SNVS 的话此位必须为 1。
接下来看一下寄存器SNVS_LPCR寄存器,此寄存器也只用到了一个位: SRTC_ENV(bit0),此位为 1 的话就使能 STC 计数器。
最后来看一下寄存器 SNVS_SRTCMR 和 SNVS_SRTCLR,这两个寄存器保存着 RTC 的秒数,SRTC计数器是32位的,SNVS_SRTCMR 的 bit14:0 这 15 位是 SRTC 计数器的高 15 位,SNVS_SRTCLR 的 bit31:bit15 这 17 位是 SRTC 计数器的低 17 位。
按照上文所述去读取这两个寄存器就可以得到正确的时间,如果要调整时间的话也是向这两个寄存器写入要设置的时间值对应的秒数就可以了,但是要修改这两个寄存器的话要先关闭 SRTC。
综上所述:配置步骤如下:
1、初始化 SNVS_SRTC
初始化 SNVS_LP 中的 SRTC。
2、设置 RTC 时间
第一次使用 RTC 肯定要先设置时间。
3、使能 RTC
配置好 RTC 并设置好初始时间以后就可以开启 RTC 了。
程序编写
我们需要先定义一些宏,比如一天多少秒、一小时多少秒等等,这些宏将用于将秒转换为时间,或者将时间转换为秒。此外还需要定义一个结构体 rtc_datetime,此结构体用于描述日期和时间参数。
rtc.h
#ifndef RTC_H
#define RTC_H
#include "imx6ul.h"
/* 相关宏定义 */
#define SECONDS_IN_A_DAY (86400) /* 一天86400秒 */
#define SECONDS_IN_A_HOUR (3600) /* 一个小时3600秒 */
#define SECONDS_IN_A_MINUTE (60) /* 一分钟60秒 */
#define DAYS_IN_A_YEAR (365) /* 一年365天 */
#define YEAR_RANGE_START (1970) /* 开始年份1970年 */
#define YEAR_RANGE_END (2099) /* 结束年份2099年 */
/* 时间日期结构体 */
struct rtc_datetime
{
unsigned short year; /* 范围为:1970 ~ 2099 */
unsigned char month; /* 范围为:1 ~ 12 */
unsigned char day; /* 范围为:1 ~ 31 (不同的月,天数不同).*/
unsigned char hour; /* 范围为:0 ~ 23 */
unsigned char minute; /* 范围为:0 ~ 59 */
unsigned char second; /* 范围为:0 ~ 59 */
};
/* 函数声明 */
void rtc_init(void);
void rtc_enable(void);
void rtc_disable(void);
unsigned int rtc_coverdate_to_seconds(struct rtc_datetime *datetime);
unsigned int rtc_getseconds(void);
void rtc_setdatetime(struct rtc_datetime *datetime);
void rtc_getdatetime(struct rtc_datetime *datetime)
;
#endif
接下来我们编写rtc.c文件,一共需要九个函数:rtc_init用于初始化rtc并将其使能,也可以在里面设置时间;rtc_enable和rtc_disable用于使能和禁止RTC;rtc_isleapyear用于判断某一年是否是闰年;rtc_coverdate_to_seconds负责将给定的日期信息转化为秒数;rtc_setdatetime用于设置时间;rtc_convertseconds_to_datetime用于将给定的秒数转换为对应的日期值;rtc_getseconds用于获取SRTC当前秒数,就是读取寄存器 SNVS_LPSRTCMR 和 SNVS_LPSRTCLR中的值;rtc_getdatetime是获取时间值。
rtc.c
/*
* 描述:初始化RTC
*/
void rtc_init(void)
{
/*
* 设置HPCOMR寄存器
* bit[31] 1 : 允许访问SNVS寄存器,一定要置1
* bit[8] 1 : 此位置1,需要签署NDA协议才能看到此位的详细说明,
* 这里不置1也没问题
*/
SNVS->HPCOMR |= (1 << 31) | (1 << 8);
#if 0
struct rtc_datetime rtcdate;
rtcdate.year = 2018U;
rtcdate.month = 12U;
rtcdate.day = 13U;
rtcdate.hour = 14U;
rtcdate.minute = 52;
rtcdate.second = 0;
rtc_setDatetime(&rtcdate); //初始化时间和日期
#endif
rtc_enable(); //使能RTC
}
/*
* 描述: 开启RTC
*/
void rtc_enable(void)
{
/*
* LPCR寄存器bit0置1,使能RTC
*/
SNVS->LPCR |= 1 << 0;
while(!(SNVS->LPCR & 0X01));//等待使能完成
}
/*
* 描述: 关闭RTC
*/
void rtc_disable(void)
{
/*
* LPCR寄存器bit0置0,关闭RTC
*/
SNVS->LPCR &= ~(1 << 0);
while(SNVS->LPCR & 0X01);//等待关闭完成
}
/*
* @description : 判断指定年份是否为闰年,闰年条件如下:
* @param - year: 要判断的年份
* @return : 1 是闰年,0 不是闰年
*/
unsigned char rtc_isleapyear(unsigned short year)
{
unsigned char value=0;
if(year % 400 == 0)
value = 1;
else
{
if((year % 4 == 0) && (year % 100 != 0))
value = 1;
else
value = 0;
}
return value;
}
/*
* @description : 将时间转换为秒数
* @param - datetime: 要转换日期和时间。
* @return : 转换后的秒数
*/
unsigned int rtc_coverdate_to_seconds(struct rtc_datetime *datetime)
{
unsigned short i = 0;
unsigned int seconds = 0;
unsigned int days = 0;
unsigned short monthdays[] = {0U, 0U, 31U, 59U, 90U, 120U, 151U, 181U, 212U, 243U, 273U, 304U, 334U};
for(i = 1970; i < datetime->year; i++)
{
days += DAYS_IN_A_YEAR; /* 平年,每年365天 */
if(rtc_isleapyear(i)) days += 1;/* 闰年多加一天 */
}
days += monthdays[datetime->month];
if(rtc_isleapyear(i) && (datetime->month >= 3)) days += 1;/* 闰年,并且当前月份大于等于3月的话加一天 */
days += datetime->day - 1;
seconds = days * SECONDS_IN_A_DAY +
datetime->hour * SECONDS_IN_A_HOUR +
datetime->minute * SECONDS_IN_A_MINUTE +
datetime->second;
return seconds;
}
/*
* @description : 设置时间和日期
* @param - datetime: 要设置的日期和时间
* @return : 无
*/
void rtc_setdatetime(struct rtc_datetime *datetime)
{
unsigned int seconds = 0;
unsigned int tmp = SNVS->LPCR;
rtc_disable(); /* 设置寄存器HPRTCMR和HPRTCLR的时候一定要先关闭RTC */
/* 先将时间转换为秒 */
seconds = rtc_coverdate_to_seconds(datetime);
SNVS->LPSRTCMR = (unsigned int)(seconds >> 17); /* 设置高16位 */
SNVS->LPSRTCLR = (unsigned int)(seconds << 15); /* 设置地16位 */
/* 如果此前RTC是打开的在设置完RTC时间以后需要重新打开RTC */
if (tmp & 0x1)
rtc_enable();
}
/*
* @description : 将秒数转换为时间
* @param - seconds : 要转换的秒数
* @param - datetime: 转换后的日期和时间
* @return : 无
*/
void rtc_convertseconds_to_datetime(unsigned int seconds, struct rtc_datetime *datetime)
{
unsigned int x;
unsigned int secondsRemaining, days;
unsigned short daysInYear;
/* 每个月的天数 */
unsigned char daysPerMonth[] = {0U, 31U, 28U, 31U, 30U, 31U, 30U, 31U, 31U, 30U, 31U, 30U, 31U};
secondsRemaining = seconds; /* 剩余秒数初始化 */
days = secondsRemaining / SECONDS_IN_A_DAY + 1; /* 根据秒数计算天数,加1是当前天数 */
secondsRemaining = secondsRemaining % SECONDS_IN_A_DAY; /*计算天数以后剩余的秒数 */
/* 计算时、分、秒 */
datetime->hour = secondsRemaining / SECONDS_IN_A_HOUR;
secondsRemaining = secondsRemaining % SECONDS_IN_A_HOUR;
datetime->minute = secondsRemaining / 60;
datetime->second = secondsRemaining % SECONDS_IN_A_MINUTE;
/* 计算年 */
daysInYear = DAYS_IN_A_YEAR;
datetime->year = YEAR_RANGE_START;
while(days > daysInYear)
{
/* 根据天数计算年 */
days -= daysInYear;
datetime->year++;
/* 处理闰年 */
if (!rtc_isleapyear(datetime->year))
daysInYear = DAYS_IN_A_YEAR;
else /*闰年,天数加一 */
daysInYear = DAYS_IN_A_YEAR + 1;
}
/*根据剩余的天数计算月份 */
if(rtc_isleapyear(datetime->year)) /* 如果是闰年的话2月加一天 */
daysPerMonth[2] = 29;
for(x = 1; x <= 12; x++)
{
if (days <= daysPerMonth[x])
{
datetime->month = x;
break;
}
else
{
days -= daysPerMonth[x];
}
}
datetime->day = days;
}
/*
* @description : 获取RTC当前秒数
* @param : 无
* @return : 当前秒数
*/
unsigned int rtc_getseconds(void)
{
unsigned int seconds = 0;
seconds = (SNVS->LPSRTCMR << 17) | (SNVS->LPSRTCLR >> 15);
return seconds;
}
/*
* @description : 获取当前时间
* @param - datetime: 获取到的时间,日期等参数
* @return : 无
*/
void rtc_getdatetime(struct rtc_datetime *datetime)
{
unsigned int seconds = 0;
seconds = rtc_getseconds();
rtc_convertseconds_to_datetime(seconds, datetime);
}
最后编写我们的main.c函数,我们要实现的功能是在开机的前3s内判断是否按下按键key0,若按下则设置SRTC的日期时间,若没按下则直接读取RTC的日期并显示在RGBLCD上,每1s刷新一次。
main.c
#include "bsp_clk.h"
#include "bsp_delay.h"
#include "bsp_led.h"
#include "bsp_beep.h"
#include "bsp_key.h"
#include "bsp_int.h"
#include "bsp_uart.h"
#include "bsp_lcd.h"
#include "bsp_lcdapi.h"
#include "bsp_rtc.h"
#include "stdio.h"
/*
* @description : main函数
* @param : 无
* @return : 无
*/
int main(void)
{
unsigned char key = 0;
int i = 3, t = 0;
char buf[160];
struct rtc_datetime rtcdate;
unsigned char state = OFF;
int_init(); /* 初始化中断(一定要最先调用!) */
imx6u_clkinit(); /* 初始化系统时钟 */
delay_init(); /* 初始化延时 */
clk_enable(); /* 使能所有的时钟 */
led_init(); /* 初始化led */
beep_init(); /* 初始化beep */
uart_init(); /* 初始化串口,波特率115200 */
lcd_init(); /* 初始化LCD */
rtc_init(); /* 初始化RTC */
tftlcd_dev.forecolor = LCD_RED;
lcd_show_string(50, 10, 400, 24, 24, (char*)"RTC TEST"); /* 显示字符串 */
lcd_show_string(50, 40, 200, 16, 16, (char*)"CSND jiajia2020");
lcd_show_string(50, 60, 200, 16, 16, (char*)"2021/7/31");
tftlcd_dev.forecolor = LCD_BLUE;
memset(buf, 0, sizeof(buf));
while(1)
{
if(t==100) //1s时间到了
{
t=0;
printf("will be running %d s......\r", i);
lcd_fill(50, 90, 370, 110, tftlcd_dev.backcolor); /* 清屏 */
sprintf(buf, "will be running %ds......", i);
lcd_show_string(50, 90, 300, 16, 16, buf);
i--;
if(i < 0)
break;
}
key = key_getvalue();
if(key == KEY0_VALUE)
{
rtcdate.year = 2021;
rtcdate.month = 7;
rtcdate.day = 31;
rtcdate.hour = 18;
rtcdate.minute = 30;
rtcdate.second = 0;
rtc_setdatetime(&rtcdate); /* 初始化时间和日期 */
printf("\r\n RTC Init finish\r\n");
break;
}
delayms(10);
t++;
}
tftlcd_dev.forecolor = LCD_RED;
lcd_fill(50, 90, 370, 110, tftlcd_dev.backcolor); /* 清屏 */
lcd_show_string(50, 90, 200, 16, 16, (char*)"Current Time:"); /* 显示字符串 */
tftlcd_dev.forecolor = LCD_BLUE;
while(1)
{
rtc_getdatetime(&rtcdate);
sprintf(buf,"%d/%d/%d %d:%d:%d",rtcdate.year, rtcdate.month, rtcdate.day, rtcdate.hour, rtcdate.minute, rtcdate.second);
lcd_fill(50,110, 300,130, tftlcd_dev.backcolor);
lcd_show_string(50, 110, 250, 16, 16,(char*)buf); /* 显示字符串 */
state = !state;
led_switch(LED0,state);
delayms(1000); /* 延时一秒 */
}
return 0;
}
编译下载后,我们可以看到开发板正常运行。