stm32HAL库RTC

### STM32 HAL库 RTC 实时时钟使用教程

#### 初始化RTC实例并设置时间和日期

在STM32CubeMX中完成硬件配置后，在生成的项目代码里，需要进一步编写程序来初始化RTC实例以及设定初始的时间和日期。这一步骤确保了RTC能够按照预设值开始计时。

// 设置RTC时间
RTC_TimeTypeDef sTime = {0};
sTime.Hours = 14;
sTime.Minutes = 30;
sTime.Seconds = 0;

if (HAL_RTC_SetTime(&hrtc, &sTime, RTC_FORMAT_BIN) != HAL_OK) {
    // 错误处理
}

// 设置RTC日期
RTC_DateTypeDef sDate = {0};
sDate.WeekDay = RTC_WEEKDAY_MONDAY;
sDate.Month = RTC_MONTH_JANUARY;
sDate.Date = 1;
sDate.Year = 23;

if (HAL_RTC_SetDate(&hrtc, &sDate, RTC_FORMAT_BIN) != HAL_OK) {
    // 错误处理
}

上述代码展示了如何利用`HAL_RTC_SetTime()`函数设置具体时刻[^1]，同时也说明了怎样通过调用`HAL_RTC_SetDate()`接口指定具体的日期信息[^1]。

#### 获取当前时间和日期

为了从RTC读取最新的时间戳数据，可以采用如下方式：

RTC_TimeTypeDef currentTime;
RTC_DateTypeDef currentDate;

HAL_RTC_GetTime(&hrtc, ¤tTime, RTC_FORMAT_BIN);
HAL_RTC_GetDate(&hrtc, ¤tDate, RTC_FORMAT_BIN);

printf("Current Time: %02d:%02d:%02d\n", 
       currentTime.Hours, currentTime.Minutes, currentTime.Seconds);
printf("Current Date: %02d/%02d/20%02d (%d)\n",
       currentDate.Date, currentDate.Month, currentDate.Year, currentDate.WeekDay);

这段示例代码实现了对实时时间与日期信息的有效提取，并将其打印出来供开发者查看或用于其他逻辑运算。

#### 配置RTC闹钟功能

当涉及到更复杂的应用场景比如定时唤醒或其他基于特定时间节点触发的操作时，则需要用到RTC内置的支持闹钟机制的功能特性。下面给出了一段简单的例子用来展示如何创建一个基本的闹钟事件：

RTC_AlarmTypeDef alarmConfig = {0};

alarmConfig.AlarmTime.Hours = 8;
alarmConfig.AlarmTime.Minutes = 0;
alarmConfig.AlarmTime.Seconds = 0;
alarmConfig.AlarmMask = RTC_ALARMMASK_NONE;
alarmConfig.AlarmSubSecondMask = RTC_ALARMSSMASK_ALL;
alarmConfig.AlarmDateWeekDaySel = RTC_ALARMDATEWEEKDAYSEL_DATE;
alarmConfig.AlarmDateWeekDay = 1; /* Day of the month */
alarmConfig.Alarm = RTC_ALARM_A;

if(HAL_RTC_SetAlarm_IT(&hrtc, &alarmConfig, RTC_FORMAT_BIN)!= HAL_OK){
    // 处理错误情况
}

这里定义了一个每天早上八点钟激活中断请求IRQ的报警条件[^2]。值得注意的是除了小时分钟秒钟外还可以针对月份天数星期几等参数做更加精细灵活地调整以满足不同需求下的应用场景[^3]。