STM32HAL库中RTC闹钟设置时分秒，年月日

在STM32的HAL库中，RTC（实时时钟）模块提供了多种功能来管理时间和日期，包括设置闹钟。对于RTC闹钟功能，确实主要集中在时、分、秒的配置上，但年、月、日也可以通过RTC日期寄存器进行设置，并且可以与闹钟功能结合使用。

注意：

对于 STM32F103ZET6 来说，其RTC确实可以配置时间（小时、分钟、秒）和日期（年、月、日），但是它的RTC硬件并不直接支持带有特定日期的闹钟功能。这意味着你不能直接通过RTC硬件设置一个仅在某一天触发的闹钟。

RTC 日期和时间设置

首先，需要明确的是，RTC不仅能够设置当前的时间（小时、分钟、秒），还可以设置当前的日期（年、月、日）。这可以通过 HAL_RTC_SetTime() 和 HAL_RTC_SetDate() 函数来完成。

设置时间

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_DateTypeDef sDate = {0};
sDate.WeekDay = RTC_WEEKDAY_TUESDAY;
sDate.Month = RTC_MONTH_JULY;
sDate.Date = 15;
sDate.Year = 23; // 从2000年开始计算，这里是2023年
if (HAL_RTC_SetDate(&hrtc, &sDate, RTC_FORMAT_BIN) != HAL_OK) {
    // 错误处理
}

RTC 闹钟设置

RTC 闹钟可以配置为仅基于时间（时、分、秒）触发，也可以配置为基于日期（年、月、日）和时间一起触发。为了实现后者，你需要利用 RTC_AlarmTypeDef 结构体中的相关字段。

配置闹钟

RTC_AlarmTypeDef sAlarm = {0};

// 设置闹钟时间为每天的14:30:00
sAlarm.AlarmTime.Hours = 14;
sAlarm.AlarmTime.Minutes = 30;
sAlarm.AlarmTime.Seconds = 0;

// 设置闹钟日期（可选）
// 如果你希望闹钟只在特定日期触发，可以配置以下字段：
// 注意：不是所有STM32系列都支持这些字段，具体取决于硬件。
// sAlarm.AlarmDateWeekDaySel = RTC_ALARMDATEWEEKDAYSEL_DATE; // 使用日期而不是星期几
// sAlarm.AlarmDateWeekDay = 15; // 月份中的某一天
// sAlarm.AlarmMask = RTC_ALARMMASK_NONE; // 不屏蔽任何字段

// 选择闹钟A或B，并配置其他选项
sAlarm.Alarm = RTC_ALARM_A;
sAlarm.AlarmMask = RTC_ALARMMASK_NONE; // 或者根据需要配置掩码
sAlarm.AlarmSubSecondMask = RTC_ALARMSUBSECONDMASK_ALL;
sAlarm.AlarmDateWeekDaySel = RTC_ALARMDATEWEEKDAYSEL_DATE;
sAlarm.AlarmDateWeekDay = 15; // 例如7月15日

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

关键点

闹钟日期配置 ：虽然并非所有的STM32系列都支持直接配置闹钟的具体日期，但对于支持该特性的MCU，你可以通过 RTC_AlarmTypeDef 中的相关字段来指定具体的日期。如果硬件不支持，则只能依赖于应用程序逻辑来判断是否到了特定日期再触发相应的动作。
闹钟掩码 ：使用 AlarmMask 字段可以选择哪些部分参与比较（如小时、分钟、秒等）。如果你想让闹钟在每天相同的时间触发，而不考虑日期，则可以设置掩码来忽略日期部分。
中断和服务例程：当闹钟条件满足时，会触发一个中断。你需要编写相应的中断服务程序来处理这个事件，比如执行某些任务或者唤醒系统。

示例代码

以下是一个完整的示例代码片段，用于设置RTC时间和日期，并配置一个每天触发的闹钟：

#include "stm32f4xx_hal.h"

RTC_HandleTypeDef hrtc;

void SystemClock_Config(void);
static void MX_GPIO_Init(void);
static void MX_RTC_Init(void);

int main(void)
{
    HAL_Init();
    SystemClock_Config();
    MX_GPIO_Init();
    MX_RTC_Init();

    // 设置时间
    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_DateTypeDef sDate = {0};
    sDate.WeekDay = RTC_WEEKDAY_TUESDAY;
    sDate.Month = RTC_MONTH_JULY;
    sDate.Date = 15;
    sDate.Year = 23;
    if (HAL_RTC_SetDate(&hrtc, &sDate, RTC_FORMAT_BIN) != HAL_OK) {
        // 错误处理
    }

    // 设置闹钟
    RTC_AlarmTypeDef sAlarm = {0};
    sAlarm.AlarmTime.Hours = 14;
    sAlarm.AlarmTime.Minutes = 30;
    sAlarm.AlarmTime.Seconds = 0;
    sAlarm.Alarm = RTC_ALARM_A;
    sAlarm.AlarmMask = RTC_ALARMMASK_NONE;
    sAlarm.AlarmSubSecondMask = RTC_ALARMSUBSECONDMASK_ALL;
    sAlarm.AlarmDateWeekDaySel = RTC_ALARMDATEWEEKDAYSEL_DATE;
    sAlarm.AlarmDateWeekDay = 15; // 例如7月15日
    if (HAL_RTC_SetAlarm_IT(&hrtc, &sAlarm, RTC_FORMAT_BIN) != HAL_OK) {
        // 错误处理
    }

    while (1) {
        // 主循环
    }
}

void HAL_RTC_AlarmAEventCallback(RTC_HandleTypeDef *hrtc) {
    // 处理闹钟事件
}

请注意，上述代码假设你已经在CubeMX或其他工具中正确初始化了RTC外设。如果你的MCU型号不支持特定日期的闹钟配置，那么你需要通过软件逻辑来实现这一功能，比如每天检查当前日期并在特定日期触发特定行为。