（一）工程配置
, J; N1 r0 r( M/ R! H; h! g; K我使用STM32F103RB这一款MCU，首先使用STM32CUBEMX创建工程，配置主时钟和RTC时钟，我板子上是使用的外部的32.768K晶振供RTC：
0 e3 }  V% C1 Q' r& P% i, u, h
5 o1 v; H" F/ Q
0 [. h: }, F, H# N& [

$ U* m. l! O  B6 n3 F) g配置了两个LED灯：
% a3 |+ U! Z( m$ Q+ o/ g; C( ^
% C! a, A/ @' B' u, ^. m- N

. |! f4 p7 {5 d/ o: {配置调试下载接口为SWD（此步骤如果不配置，你使用stlink的话下载一次程序之后就再次下载就会找不到MCU）：
, [7 P  O6 m/ R' O  s$ L2 v6 N) R  V
  }" ]) z6 M5 K. v9 p5 E1 s
( R3 Q; C' L' b( l( P& ~
' @1 s; K0 M. |配置串口1：


7 C8 G1 f9 q. M+ X! R
' m" J/ z9 p# r) e配置RTC时钟，激活日历和时钟源，这里我设置时间为2020年12月25日0点0分0秒，设置闹钟提醒的时间为3s：

! ?5 S' i% d4 c- Q6 Q
+ R- T1 q  \% u7 l, X& C& P2 k
使能RTC闹钟提醒功能的中断：
6 H& S$ o  t1 f+ N' I: g
( @$ ~, M- V- ~8 e; _

2 U& L8 o$ q' X1 [) \5 D2 T其他工程设置：

, x- J" L: `2 U$ z. @& t/ Z

然后生成工程就可以了。
4 W' A- _' P& j7 E
" ^/ t, `9 E6 Z3 d" b. B$ E" p8 L（二）代码编写
% @) r' d9 x$ z4 z5 z! R  m重定向printf函数：
# r% j/ ^" e. i$ f+ @; z8 y1 O" r

1. int fputc(int ch, FILE* fp)
   ; t8 D; `/ u' m- J; h0 V) x- D( S$ a
2. {
   # K+ m1 O) V9 w5 G: |
3.     while(__HAL_UART_GET_FLAG(&huart1, UART_FLAG_TXE) != SET);
   
4.     huart1.Instance->DR = ch & 0XFF;
   & E. h: C" f/ R3 l- z3 w+ M! }
5.     return ch;
   
6. }

复制代码

  Y- i/ [6 ?- ~( R" b1 U, R/ I: @! ~HAL库获取RTC时间的函数有两个：
HAL_RTC_GetTime：获取时间
3 u  S  r- W1 Y" vHAL_RTC_GetDate：获取日期

1 r  V- a; y8 e/ o这两个函数的第三个参数是格式：RTC_FORMAT_BIN和RTC_FORMAT_BCD，BIN格式就是十六进制数值直接表示的时间数值，BCD格式就是用数值的十六进制面值表示时间数值，例如表示第24分钟的时候，BCD格式的分钟值就是0X24。

注意： 这两个函数调用是有先后顺序的，必须先调用HAL_RTC_GetTime然后在调用HAL_RTC_GetDate。

可以通过以下两个函数设置时间：
% s( k6 z' I0 S! Q& R" @HAL_RTC_SetTime
HAL_RTC_SetDate
+ g3 P) r( t7 d$ S+ ]$ t% G+ ^
+ i9 k6 d! R, q1 f- [1 n! F这里我简单的把时间设置的函数做了个封装：

1. #pragma pack(1)
   
2. typedef struct
   
3. {
   
4.     uint8_t Hours;
   
5.     uint8_t Minutes;
   
6.     uint8_t Seconds;
   
7.     uint8_t WeekDay;
   
8.     uint8_t Month;
   / h4 x5 r7 Z( u6 F0 z- \/ U
9.     uint8_t Day;
   # I- |% z) L3 V2 N
10.     uint8_t Year;
    
11. } rtc_time_t;
    0 @( Q7 d& A' s; L1 P$ E7 X7 W
12. #pragma pack()
    : |; e- o. [1 M
13. 
    
14. 
    
15. void RTC_GetTime(rtc_time_t* time)
    # U3 T3 z  F) e
16. {
    
17.     HAL_RTC_GetTime(&hrtc, (RTC_TimeTypeDef *)&time->Hours,   RTC_FORMAT_BIN);
    . A* \3 I3 ~+ \- U9 t5 S
18.     HAL_RTC_GetDate(&hrtc, (RTC_DateTypeDef *)&time->WeekDay, RTC_FORMAT_BIN);
    
19. }
    
20. 
    
21. void RTC_SetTime(rtc_time_t* time)
    ( _8 ?+ Z+ i) `$ G$ L- A: Q, A
22. {
    
23.     HAL_RTC_SetTime(&hrtc, (RTC_TimeTypeDef *)&time->Hours,   RTC_FORMAT_BIN);
    3 h$ b% s  I' V; z' D( Y
24.     HAL_RTC_SetDate(&hrtc, (RTC_DateTypeDef *)&time->WeekDay, RTC_FORMAT_BIN);
    ( R( L6 F5 k5 n0 M# O
25. }

复制代码

" O2 G. w1 j# |3 U覆写闹钟时间回调函数：

闹钟事件的中断设置，要看MCU支持的是秒中断还是时间中断，比如10X系列，要通过当前时间去设置下一次闹钟，而40X系列的可以直接设置时间。
+ u* y- O& ^) L+ B. p
: b  }0 m9 K* {& o

1. void HAL_RTC_AlarmAEventCallback(RTC_HandleTypeDef *hrtc)
   
2. {
   ) q* N% Z9 k  N9 ]7 T
3.     RTC_AlarmTypeDef sAlarm = {0};
   , N3 ~6 b& F9 T1 @# y
4.     rtc_time_t tim = {0};
   0 N# V2 Y2 B7 E" ?/ C0 x
5. 
   
6.         // 获取当前时间
   
7.     RTC_GetTime(&tim);
   * o, C/ l6 R0 \$ |, q9 C: H& c
8. 
   9 L- P" M% T# p
9.     sAlarm.AlarmTime.Hours = tim.Hours;
   
10.     sAlarm.AlarmTime.Minutes = tim.Minutes;
    : A" c  h( }% _+ R( }
11.     sAlarm.AlarmTime.Seconds = tim.Seconds + 3;  /* 设置下次闹钟提醒时间是当前时间的3s之后 */
    
12.     sAlarm.Alarm = RTC_ALARM_A;
    
13.         
    4 k8 a1 o# B6 F* r& f5 ]: [
14.         // 再次启动闹钟中断事件
    
15.     if (HAL_RTC_SetAlarm_IT(hrtc, &sAlarm, RTC_FORMAT_BIN) != HAL_OK)
    & @, ^  K! I2 G! e! @7 H) h7 [8 F
16.     {
    
17.         Error_Handler();
    
18.     }
    : A: o! h! ^% z% g
19.         
    
20.     printf("HAL_RTC_AlarmAEventCallback\r\n");
    
21. }

复制代码

main函数：
$ g$ [* T9 W+ I4 ^

1. int main(void)
   3 v) B1 R" v! p5 P
2. {
   0 h+ r; t/ g$ j* s$ g. a- R
3.     rtc_time_t tim = {0};
   2 E: u: e7 B$ T+ f
4.         
   
5.     HAL_Init();
     Y/ J7 q" r3 Y5 ^4 U3 A9 H8 p
6.     SystemClock_Config();
   
7.     MX_GPIO_Init();
   
8.     MX_USART1_UART_Init();
   
9.     MX_RTC_Init();
   1 E. j( O. {* a5 g3 W
10. 
    
11.     while (1)
    
12.     {
    
13.         HAL_GPIO_TogglePin(LED0_GPIO_Port, LED0_Pin);
    
14.         RTC_GetTime(&tim);
    # U; v, M: h* O% s$ q
15.         printf("%02d/%02d/%02d %02d:%02d:%02d %d\r\n", tim.Year, tim.Month, tim.Day, tim.Hours, tim.Minutes, tim.Seconds, tim.WeekDay);
    
16.                 HAL_Delay(1000);
    * r$ |0 J8 i; F% g. E$ P
17.     }
    
18. }

复制代码

（三）运行效果

1 d. T/ D- }$ w- X4 i