一、RTC简介

RTC（Real Time Clock）实时时钟，它是一个独立的定时器。RTC模块拥有一组连续计数的计数器，在相应软件配置下，可提供时钟日历的功能。修改计数器的值可以重新设置系统当前的时间和日期。

RTC模块和时钟配置都是在后备区域，无论单片机处于何种状态，只要保证后备区正常供电，RTC就会一直工作。

二、STM32的RTC

2.1 主要特性

• 可编程的预分频系数 ：分频系数最高为2^20
• 32位的可编程计数器 ，可用于较长时间段的测量
• 可以选择以下三种RTC的时钟源 ─ HSE时钟除以128 ─ LSE振荡器时钟 ─ LSI振荡器时钟
• 3个专门的可屏蔽中断 ─ 闹钟中断，用来产生一个软件可编程的闹钟中断 ─ 秒中断，用来产生一个可编程的周期性中断信号(最长可达1秒) ─ 溢出中断，指示内部可编程计数器溢出并回转为0的状态
22.2 RTC框图介绍
RTC框图
• RTCCLK通常选择低功耗32.768kHz外部晶振(LSE)
• RTC预分频器通常设置为32768，LES时钟经过RTC预分频器，输入频率变为1Hz，也就是1秒
• RTC_CNT输入时钟为1Hz时，1s加1次
• RTC_ALR是用来做闹钟的，RTC_CNT的值会与RTC_ALR的值进行比较，二者相等时，会产生闹钟中断
三、访问后备区域步骤

STM32系统复位之后，对后备寄存器和RTC的访问被禁止 ，这是为了防止对后备区域(BKP)的意外写操作。执行以下操作，可以访问后备区域寄存器

• 设置寄存器RCC_APB1ENR的PWREN和BKPEN位，使能电源和后备接口时钟
• 设置寄存器PWR_CR的DBP位，使能对后备寄存器和RTC的访问

完成上面的设置之后，就可以操作后备寄存器。第一次通过APB1总线访问RTC时，需要等待APB1和RTC同步，确保读取出来的RTC的寄存器值是正确的。如果同步之后，一直没有关闭APB1和RTC外设接口，就不需要再同步了。

如果内核需要对RTC寄存器写入数据，在内核发送指令后，RTC会在3个RTCCLK时钟之后，开始写入数据。每次写入时，必须要检查RTC关闭操作标志位RTOFF是否置1来判断是否写操作完成。

四、RTC配置步骤

• 使能电源时钟和后备域时钟，开启RTC后备寄存器写访问
• 复位备份区域，开启外部低速振荡器（LSE）
• 选择RTC时钟，并使能
• 设置RTC的分频系数，配置RTC时钟
• 更新配置，设置RTC中断分组
• 编写RTC中断服务函数
五、RTC程序配置
55.1 RTC结构体定义

// RTC结构体
typedef struct 
{
    // 时分秒
    u8 hour;
    u8 min;
    u8 sec;
    
    // 年月日周
    u16 w_year;
    u8  w_month;
    u8  w_date;
    u8  week;   
}_calendar;

5.2 RTC初始化函数

/*
 *==============================================================================
 *函数名称：RTC_Init
 *函数功能：初始化RTC
 *输入参数：无
 *返回值：0：成功；1：失败
 *备  注：无
 *==============================================================================
 */
u8 RTC_Init (void)
{
    u8 temp=0;   // 超时监控变量
    // 结构体定义
    NVIC_InitTypeDef NVIC_InitStructure;
    
    // 使能PWR和BKP外设时钟  
    RCC_APB1PeriphClockCmd(RCC_APB1Periph_PWR | RCC_APB1Periph_BKP, ENABLE); 
    PWR_BackupAccessCmd(ENABLE);   // 使能后备寄存器访问
    
    // 检测是否是第一次配置RTC
    // 配置时会想RTC寄存器写入0xA0A0，如果读出的数据不是0xA0A0，认为是第一次配置RTC
    if (BKP_ReadBackupRegister(BKP_DR1) != 0xA0A0)
    {    
        BKP_DeInit();   // 复位备份区域  
        RCC_LSEConfig(RCC_LSE_ON);   // 设置外部低速晶振(LSE),使用外设低速晶振
        
        // 等待低速晶振就绪
        while (RCC_GetFlagStatus(RCC_FLAG_LSERDY) == RESET&&temp< 250)
        {
            temp++;
            delay_ms(10);
        }
        // 初始化时钟失败,晶振有问题 
        if(temp >=250)
        {
            return 1;
        }   
        
        RCC_RTCCLKConfig(RCC_RTCCLKSource_LSE);   // 设置RTC时钟(RTCCLK),选择LSE作为RTC时钟    
        RCC_RTCCLKCmd(ENABLE);   // 使能RTC时钟  
        RTC_WaitForLastTask();   // 等待最近一次对RTC寄存器的写操作完成
        
        RTC_WaitForSynchro();   // 等待RTC寄存器同步
        RTC_ITConfig(RTC_IT_SEC, ENABLE);   // 使能RTC秒中断
        RTC_WaitForLastTask();   // 等待最近一次对RTC寄存器的写操作完成
        
        RTC_EnterConfigMode();   // 允许配置 
        RTC_SetPrescaler(32767);   // 设置RTC预分频的值
        RTC_WaitForLastTask();   // 等待最近一次对RTC寄存器的写操作完成
        
        RTC_Set_Date(2023,6,26,11,15,00);   // 设置初始时间 
        RTC_ExitConfigMode();   // 退出配置模式  
        BKP_WriteBackupRegister(BKP_DR1, 0XA0A0);   // 向指定的后备寄存器中写入用户程序数据
    }
    // 系统继续计时
    else
    {
        RTC_WaitForSynchro();   // 等待最近一次对RTC寄存器的写操作完成
        RTC_ITConfig(RTC_IT_SEC, ENABLE);   // 使能RTC秒中断
        RTC_WaitForLastTask();   // 等待最近一次对RTC寄存器的写操作完成
    }
    
  // 配置RTC中断分组
    NVIC_InitStructure.NVIC_IRQChannel = RTC_IRQn;   // RTC全局中断
    NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority = 0;   // 先占优先级1位,从优先级3位
    NVIC_InitStructure.NVIC_IRQChannelSubPriority = 0;   // 先占优先级0位,从优先级4位
    NVIC_InitStructure.NVIC_IRQChannelCmd = ENABLE;   // 使能该通道中断
    NVIC_Init(&NVIC_InitStructure);   // 根据NVIC_InitStruct中指定的参数初始化外设NVIC寄存器
    
    RTC_Get_CurDate();   // 获取当前时间 
    return 0;   // 配置成功
}

初始化函数使用时，可以用while等待初始化成功，但是需要增加一个超时检测，这里简单给出一个写法，如果1s内，RTC没有初始化成功，直接跳过

u32 tempVar = 0;   // 初始化RTC时的超时计数变量
    
    while (RTC_Init() && tempVar < 100)   // RTC初始化
    {
        delay_ms (10);
        // 10ms自加1
        tempVar = tempVar + 1;
    }

5.3 设置年月日，时分秒

/*
 *==============================================================================
 *函数名称：RTC_Set_Date
 *函数功能：设置RTC的年月日，时分秒
 *输入参数：无
 *返回值：0：成功；1：失败
 *备  注：时间范围为1970年到2099年，可修改
 *==============================================================================
 */
u8 RTC_Set_Date (u16 syear,u8 smon,u8 sday,u8 hour,u8 min,u8 sec)
{
    u16 t;
    u32 seccount=0;
    
    // 判断是否为合法年份
    if(syear < 1970 || syear > 2099)
    {
        return 1;
    }
    
    for(t = 1970;t < syear;t ++)   // 把所有年份的秒钟相加
    {
        // 闰年的秒钟数
        if(Is_Leap_Year(t))
        {
            seccount += 31622400;
        }
        // 平年的秒钟数
        else
        {
            seccount += 31536000;
        }
    }
    
    smon -= 1;
    
    for(t = 0;t < smon;t ++)   // 把前面月份的秒钟数相加
    {
        seccount += (u32)mon_table[t] * 86400;   // 月份秒钟数相加
        // 闰年2月份增加一天的秒钟数
        if(Is_Leap_Year(syear) && t == 1)
        {
            seccount += 86400;
        }   
    }
    seccount += (u32)(sday-1) * 86400;   // 把前面日期的秒钟数相加 
    
    seccount += (u32)hour * 3600;   // 小时秒钟数
    
    seccount += (u32)min*60;   // 分钟秒钟数
    
    seccount += sec;   // 最后的秒钟加上去

    RCC_APB1PeriphClockCmd(RCC_APB1Periph_PWR | RCC_APB1Periph_BKP, ENABLE);   // 使能PWR和BKP外设时钟  
    PWR_BackupAccessCmd(ENABLE);   // 使能RTC和后备寄存器访问
    
    RTC_SetCounter(seccount);   // 设置RTC计数器的值

    RTC_WaitForLastTask();   // 等待最近一次对RTC寄存器的写操作完成   
    return 0;     
}

5.4 判断闰年函数

/*
 *==============================================================================
 *函数名称：Is_Leap_Year
 *函数功能：判断输入年份是否为闰年
 *输入参数：无
 *返回值：0：不是闰年；1：是闰年
 *备  注：四年一闰；百年不闰，四百年再闰
 *==============================================================================
 */
u8 Is_Leap_Year (u16 year)
{
    // 是否能被4整除
    if(year % 4 == 0)
    {
        // 是否能被100整除
        if(year % 100 == 0) 
        {
            // 如果以00结尾,还要能被400整除 
            if(year % 400 == 0)
            {
                return 1;
            }
            // 是100的倍数，但是不是400的倍数
            else
            {
                return 0;
            }    
        }
        // 是4的倍数，不是100的倍数
        else
        {
            return 1; 
        }   
    }
    // 不是4的倍数
    else
    {
        return 0; 
    }
}

5.5 获取当前年月日，时分秒

/*
 *==============================================================================
 *函数名称：RTC_Get_CurDate
 *函数功能：获取当前年月日，时分秒
 *输入参数：无
 *返回值：0：成功；1：失败
 *备  注：无
 *==============================================================================
 */
u8 RTC_Get_CurDate (void)
{
    // 存储上一次的总天数值，用来监测时间变化是否超过一天
    static u16 daycnt = 0;
    u32 timecount = 0; 
    // 临时计算变量
    u32 temp = 0;
    u16 temp1 = 0;
    
    timecount = RTC_GetCounter();   // 获取当前总秒数
    
     temp = timecount / 86400;   // 得到总天数
    
    // 超过一天了
    if(daycnt != temp)
    {
        daycnt = temp;   // 更新当前总天数值
        
        temp1 = 1970;   // 从1970年开始，计算当前年份
        while(temp >= 365)
        {
            // 是闰年
            if(Is_Leap_Year(temp1))
            {
                // 已经过完了366天
                if(temp >= 366)
                {
                    temp -= 366;   // 闰年的天数
                }
                // 刚过完365天，当前是第366天
                else
                {
                    temp1 ++;   // 年份加1
                    break;
                }
            }
            // 是平年
            else
            {
                temp -= 365;   // 平年的天数
            }
            temp1 ++;   // 年份加1
        }
        
        calendar.w_year = temp1;   // 得到年份
        temp1=0;   // 清零临时计算变量
        
        // 此时temp为小于一年的天数，开始计算当前月份
        while(temp >= 28)   // 超过了一个月
        {
            // 当年是闰年的2月份
            if(Is_Leap_Year(calendar.w_year) && temp1 == 1)
            {
                // 是闰年的二月份且天数大于等于29天
                if(temp >= 29)
                {
                    temp -= 29;   // 闰年的2月份天数
                }
                // 是闰年的2月份，天数小于闰年2月份天数
                else
                {
                    break;
                }
            }
            // 是平年
            else 
            {
                // 查询月份天数表
                if(temp >= mon_table[temp1])
                {
                    // 超过当月天数，减去
                    temp -= mon_table[temp1];
                }
                else
                {
                    break;
                }
            }
            temp1 ++;   // 月份加1
        }
        // 加1是因为月份表索引是0~11
        calendar.w_month = temp1 + 1;   // 得到月份
        // 当前日期为已经过去的天数加1
        calendar.w_date = temp + 1;   // 得到日期 
    }
    temp = timecount % 86400;   // 得到秒钟数       
    calendar.hour = temp / 3600;   // 小时
    calendar.min = (temp % 3600) / 60;   // 分钟 
    calendar.sec = (temp % 3600) % 60;   // 秒钟
    calendar.week = RTC_Get_Week(calendar.w_year,calendar.w_month,calendar.w_date);   // 获取星期
    
    return 0;
}

5.6 获取星期几

该函数设计是根据蔡勒公式设计，程序如下

/*
 *==============================================================================
 *函数名称：RTC_Get_Week
 *函数功能：获取当前是星期几
 *输入参数：year：当前年；month：当前月；day：当前日
 *返回值：星期几
 *备  注：无
 *==============================================================================
 */
u8 RTC_Get_Week (u16 year,u8 month,u8 day)
{ 
    u16 temp;
    u8 yearH,yearL;
    
    yearH = year / 100;
    yearL = year % 100;
    
    // 如果为21世纪,年份数加100  
    if (yearH > 19)
    {
        yearL += 100;
    }
    
    // 所过闰年数只算1900年之后的  
    temp = yearL + yearL / 4;
    temp = temp % 7; 
    temp = temp + day + table_week[month - 1];
    
    if (yearL % 4 == 0 && month < 3)
    {
        temp --;
    }
    
    return(temp % 7);
}

5.7 中断服务函数

/*
 *==============================================================================
 *函数名称：RTC_IRQHandler
 *函数功能：RTC中断服务函数
 *输入参数：无
 *返回值：无
 *备  注：更新时间
 *==============================================================================
 */
void RTC_IRQHandler(void)
{
    // 秒中断
    if (RTC_GetITStatus(RTC_IT_SEC) != RESET)
    {       
        RTC_Get_CurDate();   // 获取当前时间
        // 串口打印当前时间
        printf("RTC Time:%d-%d-%d %d:%d:%d   Week:%dn",calendar.w_year,calendar.w_month,calendar.w_date,
                calendar.hour,calendar.min,calendar.sec,calendar.week);
     }             
    RTC_ClearITPendingBit(RTC_IT_SEC | RTC_IT_OW);   //清除秒中断标志位
    RTC_WaitForLastTask();   // 等待最近一次对RTC寄存器的写操作完成              
}

六、拓展

在实际使用时，通常会通过网络授时，也就是利用WIFI模块连接网络，请求API获得初始时间。但是可能会存在些许差异。比如请求API后，获得的时间为2023.06.26.14:48:00。实际单片机解析出时间时已经过去了几秒或者十几秒，或者其他问题导致了实际解析出时间后已经与实际值有差距。此时就需要对时间进行矫正。博主在实际应用时差了14s，这里贴一下当时的矫正程序。可能大家用不到，这里只是觉得思考的过程有意思，所以贴出来分享一下。

void RTC_Time_Correct(void)   // 开机时间校正
{
    // 加14秒不满1分钟
    if (gTimeSec < 46)
    {
        gTimeSec = gTimeSec + 14;
    }
    // 加14秒满1分钟
    else if (gTimeSec >= 46)
    {
        gTimeSec = gTimeSec + 14 - 60;
        
        // 分钟数需要加1
        // 加1分钟不满1小时
        if (gTimeMin < 59)
        {
            gTimeMin = gTimeMin + 1;
        }
        // 分钟数加1满1小时
        else if (gTimeMin == 59)
        {
            gTimeMin = 0;
            
            // 小时数需要加1
            // 加1小时不满1天
            if (gTimeHour < 23)
            {
                gTimeHour = gTimeHour + 1;
            }
            // 加1小时满1天
            else if (gTimeHour == 23)
            {
                gTimeHour = 0;
                // 天数需要加1
                // 天数小于28直接加1
                if (gTimeDay < 28)
                {
                    gTimeDay = gTimeDay + 1;
                }
                // 天数等于28
                else if (gTimeDay == 28)
                {
                    // 当前为二月
                    if (gTimeMon == 2)
                    {
                        // 闰年
                        if (Is_Leap_Year(gTimeYear))
                        {
                            gTimeDay = gTimeDay + 1;
                        }
                        // 当前为2月且不是闰年
                        else
                        {
                            gTimeDay = 0;   // 天数置零
                            gTimeMon = gTimeMon + 1;   // 月份加1
                        }
                    }
                }
                // 天数等于30
                else if (gTimeDay == 30)
                {
                    // 当前月份只有30天
                    if (gTimeMon == 2 || gTimeMon == 4 || gTimeMon == 6 || gTimeMon == 9
                          || gTimeMon == 11)
                    {
                        gTimeDay = 0;
                        gTimeMon = gTimeMon + 1;
                    }
                    // 当前月份有31天
                    else
                    {
                        gTimeDay = gTimeDay + 1;
                    }
                }
                // 天数等于31
                else if (gTimeDay == 31)
                {
                    gTimeDay = 0;
                    
                    // 加1月不满1年
                    if (gTimeMon != 12)
                    {
                        gTimeMon = gTimeMon + 1;
                    }
                    else
                    {
                        gTimeMon = 1;
                        gTimeYear = gTimeYear + 1;
                    }
                }
            }
        }
    }
}