（一）工程配置
我使用STM32F103RB这一款MCU，首先使用STM32CUBEMX创建工程，配置主时钟和RTC时钟，我板子上是使用的外部的32.768K晶振供RTC：

" s' k) f; Y: Z1 N9 c" P+ ~
3 i3 l, \# z: g

配置了两个LED灯：

3 f1 P' Q' V/ u

' S2 _. Z; V4 E0 ?3 v3 g配置调试下载接口为SWD（此步骤如果不配置，你使用stlink的话下载一次程序之后就再次下载就会找不到MCU）：
0 n1 z+ M- }7 E/ V
9 \9 V' m! _  {6 s. ~0 [' _

7 A/ J+ Z& t9 S& V8 j. R* d7 L! c配置串口1：
7 Y; N9 m# ?7 s5 d- S# Q


; K5 r  x2 r) \. A5 V' J配置RTC时钟，激活日历和时钟源，这里我设置时间为2020年12月25日0点0分0秒，设置闹钟提醒的时间为3s：



9 L/ V1 d$ g% |( `+ i) b使能RTC闹钟提醒功能的中断：



- @/ Z2 [( B7 A4 T7 F7 v其他工程设置：
8 f- E7 M6 Y/ e  A% g! M

0 V" B1 d% ]$ l; s) x2 v3 F
然后生成工程就可以了。
" a& K0 ]: ?5 y( ^- h0 `0 F
（二）代码编写
* t% z4 B6 ?# V! X重定向printf函数：

; O7 b' Y: C( a  t4 U

1. int fputc(int ch, FILE* fp)
   : \" O$ A# T$ ~2 p
2. {
   ! ]5 u2 ]$ b6 k: ^" h- b
3.     while(__HAL_UART_GET_FLAG(&huart1, UART_FLAG_TXE) != SET);
   
4.     huart1.Instance->DR = ch & 0XFF;
   
5.     return ch;
   8 B8 F1 p- \7 P2 S& J
6. }

复制代码

HAL库获取RTC时间的函数有两个：
HAL_RTC_GetTime：获取时间
HAL_RTC_GetDate：获取日期
) h6 d0 V) o- X' |4 B; M5 D
这两个函数的第三个参数是格式：RTC_FORMAT_BIN和RTC_FORMAT_BCD，BIN格式就是十六进制数值直接表示的时间数值，BCD格式就是用数值的十六进制面值表示时间数值，例如表示第24分钟的时候，BCD格式的分钟值就是0X24。

! R* m5 ]* u; F+ N( i; L注意： 这两个函数调用是有先后顺序的，必须先调用HAL_RTC_GetTime然后在调用HAL_RTC_GetDate。
1 s4 G" e2 {- f& b3 `, I! }
0 b9 v* d9 f) c6 U; w2 r4 I3 `可以通过以下两个函数设置时间：
HAL_RTC_SetTime
8 a, j8 E$ W( q6 U# p$ q5 S5 r' `HAL_RTC_SetDate

, e/ G/ P  y  A2 ~0 ^* q9 c这里我简单的把时间设置的函数做了个封装：

$ E4 m! R- I( z- n

1. #pragma pack(1)
   
2. typedef struct
   - w( q' V/ _% M) b' }( n2 k( `
3. {
   5 H2 [/ Z  T  F( u$ q
4.     uint8_t Hours;
   
5.     uint8_t Minutes;
   4 H* Y- m) E1 @, C. ~% u6 ^/ z) a
6.     uint8_t Seconds;
   8 H3 s9 G1 a6 G, l; n& g4 r
7.     uint8_t WeekDay;
   6 S9 d, \5 w3 d/ A/ p
8.     uint8_t Month;
   
9.     uint8_t Day;
   
10.     uint8_t Year;
    
11. } rtc_time_t;
    , N# H$ v- A1 E) c2 w3 \% n; @
12. #pragma pack()
    
13. 
    
14. 
    
15. void RTC_GetTime(rtc_time_t* time)
    
16. {
    
17.     HAL_RTC_GetTime(&hrtc, (RTC_TimeTypeDef *)&time->Hours,   RTC_FORMAT_BIN);
    ) ?& X) J  c! |1 a
18.     HAL_RTC_GetDate(&hrtc, (RTC_DateTypeDef *)&time->WeekDay, RTC_FORMAT_BIN);
    ( \! ^& t7 f' y: y6 z0 j) X
19. }
    # n- x7 j2 n6 _1 t4 l3 J8 c
20. 
    
21. void RTC_SetTime(rtc_time_t* time)
      `7 n, h  i1 n" o8 |1 r1 [* ^* x
22. {
    
23.     HAL_RTC_SetTime(&hrtc, (RTC_TimeTypeDef *)&time->Hours,   RTC_FORMAT_BIN);
    9 v6 h& ]" W* M7 l/ _# b" {
24.     HAL_RTC_SetDate(&hrtc, (RTC_DateTypeDef *)&time->WeekDay, RTC_FORMAT_BIN);
    
25. }

复制代码

覆写闹钟时间回调函数：
" O. L3 ?( N# j; F; l% Z
! F3 L7 h3 l. T, ]/ s闹钟事件的中断设置，要看MCU支持的是秒中断还是时间中断，比如10X系列，要通过当前时间去设置下一次闹钟，而40X系列的可以直接设置时间。
7 W$ ^% L2 J. O8 y; T5 B# ?  n' |

1. void HAL_RTC_AlarmAEventCallback(RTC_HandleTypeDef *hrtc)
   
2. {
   , Y' L- _% }- }
3.     RTC_AlarmTypeDef sAlarm = {0};
   & j4 a5 h! _/ V: b5 ~5 z: T
4.     rtc_time_t tim = {0};
   
5. 
   , J. A  \3 O+ n4 A% l) C& H# Q
6.         // 获取当前时间
   / n6 I2 p; L9 v% r4 I1 z
7.     RTC_GetTime(&tim);
   
8. 
   9 T' y$ V: k5 s. u4 F% J
9.     sAlarm.AlarmTime.Hours = tim.Hours;
   " j( G! O6 y: n. Q
10.     sAlarm.AlarmTime.Minutes = tim.Minutes;
    
11.     sAlarm.AlarmTime.Seconds = tim.Seconds + 3;  /* 设置下次闹钟提醒时间是当前时间的3s之后 */
    + I4 G% q0 I" s' i  B9 x
12.     sAlarm.Alarm = RTC_ALARM_A;
    
13.         
    1 k1 u% m1 G# R0 z& I8 i2 h
14.         // 再次启动闹钟中断事件
    6 b- V( B" C( |$ p
15.     if (HAL_RTC_SetAlarm_IT(hrtc, &sAlarm, RTC_FORMAT_BIN) != HAL_OK)
    ; Q1 M' E% y( d/ n5 K- G
16.     {
    - [7 ~8 g/ o' a0 H
17.         Error_Handler();
    
18.     }
    - M; \7 U! @4 ^5 l& H
19.         
    
20.     printf("HAL_RTC_AlarmAEventCallback\r\n");
    $ m/ Z+ j9 ^: U/ G* p( I0 w/ ?
21. }

复制代码

main函数：

1. int main(void)
   
2. {
   ; c- k0 j! `0 i, V9 [
3.     rtc_time_t tim = {0};
   # F. l8 f* z7 s% i$ Y+ N; X' v
4.         
   
5.     HAL_Init();
   ( k" I# I# |" h* y. ]: S9 [
6.     SystemClock_Config();
   
7.     MX_GPIO_Init();
   7 k% G+ ?0 G6 B  c
8.     MX_USART1_UART_Init();
   
9.     MX_RTC_Init();
   ; x3 V2 t  @' G% e/ q+ c8 H
10. 
    : B7 w0 c& f$ L; p* R5 n1 u7 m6 [
11.     while (1)
    # D& I2 v4 n" m# X* V
12.     {
    
13.         HAL_GPIO_TogglePin(LED0_GPIO_Port, LED0_Pin);
    
14.         RTC_GetTime(&tim);
    5 A6 N( q% @4 h' }6 ]5 O; X+ i
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);
    
17.     }
    
18. }

复制代码

（三）运行效果

- c4 [' H+ g% r, i/ G3 `. \$ _/ U6 j

5 W: h1 G  J. q; S

5 n2 u1 l; E  f" x