STM32F1xx官方资料：
《STM32中文参考手册V10》-第16章 实时时钟(RTC)
RTC实时时钟
RTC实时时钟简介
实时时钟是一个独立的定时器。RTC模块拥有一组连续计数的计数器，在相应软件配置下，可提供时钟日历的功能。修改计数器的值可以重新设置系统当前的时间和日期。RTC模块和时钟配置系统（RCC_BDCR寄存器）处于后备区域，即在系统复位或从待机模式唤醒后，RTC的设置和时间维持不变。
BKP备份寄存器简介
备份寄存器是42个16位的寄存器，可用来存储84个字节的用户应用程序数据。他们处在备份域里，当Vdd电源被切断，他们仍然由Vbat维持供电。当系统在待机模式下被唤醒，或系统复位或电源复位时，他们也不会被复位。
此外，BKP控制寄存器用来管理侵入检测和RTC校准功能。在本文中，使用备份寄存器来存储RTC的相关信息（标记时钟是否已经经过了配置）。
复位后，对备份寄存器和RTC的访问被禁止，并且备份域被保护以防止可能存在的意外的写操作。执行以下操作可以使能对备份寄存器和RTC的访问。
通过设置寄存器RCC_APB1ENR的PWREN和BKPEN位来打开电源和后备接口的时钟；电源控制寄存器(PWR_CR)的DBP位来使能对后备寄存器和RTC的访问。
RTC实时时钟的主要特征
可编程的预分频系数：分频系数最高为220；32位的可编程计数器，可用于较长时间段的测量；2个分离的时钟：用于APB1接口的PCLK1和RTC时钟（RTC时钟的频率必须小于PCLK1时钟频率的四分之一以上）；可以选择以下三种RTC的时钟源：HSE时钟除以128；LSE振荡器时钟；LSI振荡器时钟；2个独立的复位类型：APB1接口由系统复位；RTC核心（预分频器、闹钟、计数器和分频器）只能由后备域复位；3个专门的可屏蔽中断：闹钟中断，用来产生一个软件可编程的闹钟中断；秒中断，用来产生一个可编程的周期性中断信号(最长可达1秒)；溢出中断，指示内部可编程计数器溢出并回转为0的状态。RTC工作原理
RTC工作原理框图
由工作框图可以看出，RTC由两部分组成：
APB1接口：用来和APB1总线相连。通过APB1接口可以访问RTC的相关寄存器（预分频值，计数器值，闹钟值）。RTC核心：由一组可编程计数器组成，分两个主要模块：RTC预分频模块，它可以编程产生最长1秒的RTC时间基TR_CLK。如果设置了秒中断允许位，可以产生秒中断；32位的可编程计数器，可被初始化为当前时间。系统时间按TR_CLK周期累加并与存储在RTC_ALR寄存器中的可编程时间相比，当匹配时候如果设置了闹钟中断允许位，可以产生闹钟中断；如果溢出，可以产生溢出中断。
复位过程
除了RTC_PRL、RTC_ALR、RTC_CNT和RTC_DIV寄存器外，所有的系统寄存器都由系统复位或电源复位进行异步复位。RTC_PRL、RTC_ALR、RTC_CNT和RTC_DIV寄存器仅能通过备份域复位信号复位。读RTC寄存器
RTC内核完全独立于APB1接口，软件通过APB1接口对RTC相关寄存器访问。但是相关寄存器只在RTC APB1时钟进行重新同步的RTC时钟的上升沿被更新。所以软件必须先等待寄存器同步标志位（RTC_CRL的RSF位）被硬件置1才读。
这意味着，如果APB1接口曾经被关闭，而读操作又是在刚刚重新开启APB1之后，则在第一次的内部寄存器更新之前，从APB1上读出的RTC寄存器数值可能被破坏了(通常读到0)。简单地讲，在APB1接口被禁止（复位、无时钟或断电）的情况下，RTC核仍保持运行状态。接着，重新打开APB1接口，此时必须等待RTC_CRL寄存器中的RSF位（寄存器同步标志）被硬件置1，同步之后，读RTC寄存器的值才不会有误。
因此，若在读取RTC寄存器时，RTC的APB1接口曾经处于禁止状态，则软件首先必须等待RTC_CRL寄存器的RSF位被硬件置1。
写RTC寄存器
必须设置RTC_CRL寄存器中的CNF位，使RTC进入配置模式后，才能写入RTC_PRL、RTC_CNT、RTC_ALR寄存器。
另外，对RTC任何寄存器的写操作，都必须在前一次写操作结束后进行。可以通过查询RTC_CR寄存器中的RTOFF状态位，判断RTC寄存器是否处于更新中。仅当RTOFF状态位是1时，才可以写入RTC寄存器。
RTC相关配置寄存器
RTC控制寄存器高位（RTC_CRH）
作用：配置3个专门的可屏蔽中断（溢出中断、闹钟中断、秒中断）使能。
RTC控制寄存器低位（RTC_CRL）
作用：RTC操作是否完成判断、配置模式判断、寄存器同步判断、3个中断的标志位。
这个寄存器尤其重要（尤其是位5、位4、位3）：
写任何寄存器之前，必须判断上一次写操作已经结束，也就是判断RTOFF位是否置1；写CNT、ALR、PRL寄存器，必须先配置CNF位进入配置模式，修改完之后，设置CNF位为0退出配置模式；读任何寄存器，必须先判断RSF位，确定已经同步。
RTC预分频装载寄存器（RTC_PRLH、RTC_PRLL）
作用：配置RTC预分频装载值，这个值是20bit长度。
根据这个寄存器的值可以确定，TR_CLK和RTCCLK之间的关系公式：
fTR_CLK=fRTCCLK/(PRL+1)
如果输入时钟频率是32.768kHz（fRTCCLK，也就是以LSE作为时钟源)，这个寄存器中写入7FFFh（32767）可获得周期为1秒钟的信号。
RTC预分频器余数寄存器（RTC_DIVH、RTC_DIVL）
作用：获得预分频计数器的当前值，也就是从RTC预分频装载寄存器倒数到0之间的一个值（以RTCCLK为时钟）。
RTC计数器寄存器（RTC_CNTH、RTC_CNTL）
作用：存放计数器内的计数值（以TR_CLK为时钟）。
注意：由于RTC预分频器余数寄存器以RTCCLK为时钟，而RTC计数器寄存器以TR_CLK为时钟，而RTCCLK的时钟通常远远大于TR_CLK，所以利用RTC预分频器余数寄存器可以获得更准确的控制。比如，RTC计数器寄存器存储当前时间，精确到秒；但是利用由于RTC预分频器余数寄存器，可以在RTC预分频装载寄存器倒数到0的平均数处停下，从而达到0.5秒的更精确时间。
RTC闹钟寄存器（RTC_ALRH、RTC_ALRL）
作用：当RTC计数器寄存器的值与RTC闹钟寄存器的值相等的时候，触发一个闹钟事件，产生一个闹钟中断。
读写RTC寄存器的步骤
读RTC寄存器
查询RSF位（寄存器同步标志位），直至RSF的值变成1；对一个或多个RTC寄存器进行读操作。写RTC寄存器
查询RTOFF位（RTC操作关闭位），直到RTOFF的值变为1 ；置CNF位（配置标志位）值为1，进入配置模式（仅仅PRL、CNT、ALR寄存器）；对一个RTC寄存器进行写操作；清除CNF标志位，退出配置模式（仅仅PRL、CNT、ALR寄存器）；查询RTOFF，直至RTOFF位变为1以确认写操作已经完成。也就是说：对寄存器的写操作，无论是设置中断使能等等，每操作一次就需要查询一次RTOFF位。而对于PRL、CNT、ALR寄存器，还需要进入配置模式，这个就没有必要每操作一次就退出配置模式，可以等都配置完成了再退出。
RTC相关配置库函数
2个时钟源操作函数void RCC_RTCCLKConfig(uint32_t RCC_RTCCLKSource);void RCC_RTCCLKCmd(FunctionalState NewState);
作用：确定RTC的时钟源，使能RTC时钟（通常选用LSE时钟源）。
3个参数配置函数
void RTC_SetCounter(uint32_t CounterValue);void RTC_SetPrescaler(uint32_t PrescalerValue);void RTC_SetAlarm(uint32_t AlarmValue);
作用：配置预分频装载寄存器的值、计数器的值、闹钟配置。
1个中断配置函数
void RTC_ITConfig(uint16_t RTC_IT, FunctionalState NewState);
作用：配置RTC中断的选择和使能。
2个配置模式函数
void RTC_EnterConfigMode(void);void RTC_ExitConfigMode(void);
作用：前者允许RTC配置，后者退出配置模式。
2个同步函数
void RTC_WaitForLastTask(void);void RTC_WaitForSynchro(void);
作用：前者等待上次操作完成（CRL寄存器的RTOFF位），后者等待时钟同步（CRL寄存器的RSF位）。
4个状态位函数
FlagStatus RTC_GetFlagStatus(uint16_t RTC_FLAG);void RTC_ClearFlag(uint16_t RTC_FLAG);ITStatus RTC_GetITStatus(uint16_t RTC_IT);void RTC_ClearITPendingBit(uint16_t RTC_IT);
作用：前两者获取（或清除）状态标志位，后两者为获取（或清除）中断状态标志位。
其他的相关函数
void PWR_BackupAccessCmd(FunctionalState NewState);void RCC_APB1PeriphClockCmd(uint32_t RCC_APB1Periph, FunctionalState NewState);void RCC_LSEConfig(uint8_t RCC_LSE);
作用：第一个函数使能BKP后备区域访问使能，第二个函数使能PWR和BKP时钟，第三个函数开启LSE时钟（这里为什么使用这几个函数？是在上文：BKP备份寄存器简介中讲到）。
void BKP_WriteBackupRegister(uint16_t BKP_DR, uint16_t Data);uint16_t BKP_ReadBackupRegister(uint16_t BKP_DR);
作用：上面的PWR_BackupAccessCmd()函数使能BKP后备区域使能之后，就可以通过这两个函数来读BKP的寄存器，写BKP的寄存器。
RTC一般步骤
使能PWR和BKP时钟。调用函数：RCC_APB1PeriphClockCmd()；使能后备寄存器访问。调用函数：PWR_BackupAccessCmd()；配置RTC时钟源，使能RTC时钟。调用函数：RCC_RTCCLKConfig()；RCC_RTCCLKCmd()；如果使用LSE，要打开LSE：RCC_LSEConfig(RCC_LSE_ON)；设置RTC预分频系数。调用函数：RTC_SetPrescaler()；设置时间。调用函数：RTC_SetCounter()；开启相关中断（如果需要）。调用函数：RTC_ITConfig()；编写中断服务函数。调用函数：RTC_IRQHandler()；部分操作要等待写操作完成和同步。调用函数：RTC_WaitForLastTask()；RTC_WaitForSynchro()。下面按照这个一般步骤来进行一个简单的RTC程序：
//时间结构体typedef struct {vu8 hour;vu8 min;vu8 sec;//公历日月年周vu16 w_year;vu8 w_month;vu8 w_date;vu8 week; }_calendar_obj;
_calendar_obj calendar;//时钟结构体 static void RTC_NVIC_Config(void){NVIC_InitTypeDef NVIC_InitStructure;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时钟,同时检测时钟是否工作正常//BKP->DR1用于保存是否第一次配置的设置//返回0:正常//其他:错误代码u8 RTC_Init(void){//检查是不是第一次配置时钟u8 temp=0;RCC_APB1PeriphClockCmd(RCC_APB1Periph_PWR | RCC_APB1Periph_BKP, ENABLE);//使能PWR和BKP外设时钟 PWR_BackupAccessCmd(ENABLE);//使能后备寄存器访问 if (BKP_ReadBackupRegister(BKP_DR1) != 0x5050)//从指定的后备寄存器中读出数据:读出了与写入的指定数据不相乎{ BKP_DeInit();//复位备份区域 RCC_LSEConfig(RCC_LSE_ON);//设置外部低速晶振(LSE),使用外设低速晶振while (RCC_GetFlagStatus(RCC_FLAG_LSERDY) == RESET&&temp<250)//检查指定的RCC标志位设置与否,等待低速晶振就绪{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(,1,14,17,42,55); //设置时间RTC_ExitConfigMode(); //退出配置模式 BKP_WriteBackupRegister(BKP_DR1, 0X5050);//向指定的后备寄存器中写入用户程序数据}else//系统继续计时{RTC_WaitForLastTask();//等待最近一次对RTC寄存器的写操作完成RTC_ITConfig(RTC_IT_SEC, ENABLE);//使能RTC秒中断RTC_WaitForLastTask();//等待最近一次对RTC寄存器的写操作完成}RTC_NVIC_Config();//RCT中断分组设置 RTC_Get();//更新时间return 0; //ok}//RTC时钟中断//每秒触发一次 //extern u16 tcnt; void RTC_IRQHandler(void){ if (RTC_GetITStatus(RTC_IT_SEC) != RESET)//秒钟中断{RTC_Get();//更新时间 }if(RTC_GetITStatus(RTC_IT_ALR)!= RESET)//闹钟中断{RTC_ClearITPendingBit(RTC_IT_ALR);//清闹钟中断 RTC_Get();//更新时间 printf("Alarm Time:%d-%d-%d %d:%d:%d\n",calendar.w_year,calendar.w_month,calendar.w_date,calendar.hour,calendar.min,calendar.sec);//输出闹铃时间} RTC_ClearITPendingBit(RTC_IT_SEC|RTC_IT_OW);//清闹钟中断RTC_WaitForLastTask(); }//判断是否是闰年函数//月份 1 2 3 4 5 6 7 8 9 10 11 12//闰年 31 29 31 30 31 30 31 31 30 31 30 31//非闰年 31 28 31 30 31 30 31 31 30 31 30 31//输入:年份//输出:该年份是不是闰年.1,是.0,不是u8 Is_Leap_Year(u16 year){ if(year%4==0) //必须能被4整除{ if(year%100==0) { if(year%400==0)return 1;//如果以00结尾,还要能被400整除 else return 0; }else return 1; }else return 0;} //设置时钟//把输入的时钟转换为秒钟//以1970年1月1日为基准//1970~2099年为合法年份//返回值:0,成功;其他:错误代码.//月份数据表 u8 const table_week[12]={0,3,3,6,1,4,6,2,5,0,3,5}; //月修正数据表 //平年的月份日期表const u8 mon_table[12]={31,28,31,30,31,30,31,31,30,31,30,31};u8 RTC_Set(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;//月份秒钟数相加if(Is_Leap_Year(syear)&&t==1)seccount+=86400;//闰年2月份增加一天的秒钟数 }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; }//初始化闹钟 //以1970年1月1日为基准//1970~2099年为合法年份//syear,smon,sday,hour,min,sec：闹钟的年月日时分秒 //返回值:0,成功;其他:错误代码.u8 RTC_Alarm_Set(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;//月份秒钟数相加if(Is_Leap_Year(syear)&&t==1)seccount+=86400;//闰年2月份增加一天的秒钟数 }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_SetAlarm(seccount);RTC_WaitForLastTask();//等待最近一次对RTC寄存器的写操作完成 return 0; }//得到当前的时间//返回值:0,成功;其他:错误代码.u8 RTC_Get(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))//是闰年{if(temp>=366)temp-=366;//闰年的秒钟数else {temp1++;break;} }else temp-=365; //平年 temp1++; } calendar.w_year=temp1;//得到年份temp1=0;while(temp>=28)//超过了一个月{if(Is_Leap_Year(calendar.w_year)&&temp1==1)//当年是不是闰年/2月份{if(temp>=29)temp-=29;//闰年的秒钟数else break; }else {if(temp>=mon_table[temp1])temp-=mon_table[temp1];//平年else break;}temp1++; }calendar.w_month=temp1+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;} //获得现在是星期几//功能描述:输入公历日期得到星期(只允许1901-2099年)//输入参数：公历年月日 //返回值：星期号 u8 RTC_Get_Week(u16 year,u8 month,u8 day){u16 temp2;u8 yearH,yearL;yearH=year/100;yearL=year%100; // 如果为21世纪,年份数加100 if (yearH>19)yearL+=100;// 所过闰年数只算1900年之后的 temp2=yearL+yearL/4;temp2=temp2%7; temp2=temp2+day+table_week[month-1];if (yearL%4==0&&month<3)temp2--;return(temp2%7);}
int main(void){ u8 t=0;delay_init();//延时函数初始化 NVIC_PriorityGroupConfig(NVIC_PriorityGroup_2);//设置中断优先级分组为组2：2位抢占优先级，2位响应优先级uart_init(115200); //串口初始化为115200LED_Init();//LED端口初始化LCD_Init(); usmart_dev.init(SystemCoreClock/1000000);//初始化USMARTRTC_Init(); //RTC初始化POINT_COLOR=RED;//设置字体为红色 LCD_ShowString(60,50,200,16,16,"WarShip STM32");LCD_ShowString(60,70,200,16,16,"RTC TEST");LCD_ShowString(60,90,200,16,16,"ATOM@ALIENTEK");LCD_ShowString(60,110,200,16,16,"/1/14");//显示时间POINT_COLOR=BLUE;//设置字体为蓝色LCD_ShowString(60,130,200,16,16," - - "); LCD_ShowString(60,162,200,16,16," : : "); while(1){ if(t!=calendar.sec){t=calendar.sec;LCD_ShowNum(60,130,calendar.w_year,4,16); LCD_ShowNum(100,130,calendar.w_month,2,16); LCD_ShowNum(124,130,calendar.w_date,2,16); switch(calendar.week){case 0:LCD_ShowString(60,148,200,16,16,"Sunday ");break;case 1:LCD_ShowString(60,148,200,16,16,"Monday ");break;case 2:LCD_ShowString(60,148,200,16,16,"Tuesday ");break;case 3:LCD_ShowString(60,148,200,16,16,"Wednesday");break;case 4:LCD_ShowString(60,148,200,16,16,"Thursday ");break;case 5:LCD_ShowString(60,148,200,16,16,"Friday ");break;case 6:LCD_ShowString(60,148,200,16,16,"Saturday ");break; }LCD_ShowNum(60,162,calendar.hour,2,16); LCD_ShowNum(84,162,calendar.min,2,16); LCD_ShowNum(108,162,calendar.sec,2,16);LED0=!LED0;}delay_ms(10); }; }
STM32控制程序分析
RTC_Init()函数：RTC初始化函数。
按照之前的RTC一般步骤初始化RTC函数，这里需要注意的是，为了区分是否是第一次执行RTC_Init()函数，这里使用了一个flag（向BKP_DR1寄存器写入0x5050，当然写入其他的数字也都是可以的）。
if (BKP_ReadBackupRegister(BKP_DR1) != 0x5050)//从指定的后备寄存器中读出数据:读出了与写入的指定数据不相乎{ //第一次执行RTC_InitBKP_WriteBackupRegister(BKP_DR1, 0X5050);//向指定的后备寄存器中写入用户程序数据}else//系统继续计时{//不是第一次执行RTC_Init}
为什么要区分是否第一次执行RTC_Init呢？因为如果由于断电等因素，程序中断，但是RTC时钟却还是在执行中；等恢复供电，重新启动程序，这个时候就不需要再对RTC时钟进行初始化了。
同时，设置外部低速晶振（LSE），使用外设低速晶振。需要检查指定的RCC标志位设置与否，等待低速晶振就绪。
这里时间的设置是：距离1970年1月1日0点0分0秒的时间距离。其中，RTC_Get()、RTC_Set()等函数的内容涉及到时间距离转换的各种算法，就不在本文的讨论范围了。
