单片机与物联网 / 系统课时

通过 RTC Alarm 触发定时事件

通过 RTC Alarm 触发定时事件

RTC Alarm 可以让 MCU 在日历时间满足指定条件时产生中断,无需在主循环中反复检查时钟。本课使用 STM32F407 的 RTC Alarm A,实现每分钟触发一次应用事件,并通过板载 LED 验证触发时间、重复匹配条件和中断标志清除行为。

学习目标

  • 理解 RTC Alarm 的时间比较、字段屏蔽与重复触发规则。
  • 使用 STM32 HAL 配置 Alarm A、中断入口和应用事件回调。
  • 通过 LED、断点和寄存器状态验证闹钟触发与标志清除。

理解 Alarm 的匹配与中断链路

STM32F407 的 RTC 包含独立的日历计数器和 Alarm A、Alarm B 两组闹钟比较单元。Alarm A 将当前日历时间与闹钟寄存器中的时、分、秒、日期或星期进行比较。所有未被屏蔽的字段同时匹配时,硬件置位 ALRAF 标志。

启用 Alarm A 中断后,匹配事件经 EXTI Line 17 传递至 NVIC,由 RTC_Alarm_IRQHandler() 进入 HAL 中断处理,再调用 HAL_RTC_AlarmAEventCallback()。回调只通知应用发生了事件,耗时任务应放在主循环执行。

RTC Alarm A 的时间匹配、中断传递和主循环事件处理时序

Alarm 通过字段屏蔽控制重复条件。这里的屏蔽表示忽略对应字段,而不是停止整个闹钟。

AlarmMask 设置 实际匹配字段 触发规则
RTC_ALARMMASK_NONE 日期或星期、时、分、秒 指定日期或星期与时间匹配
RTC_ALARMMASK_DATEWEEKDAY 时、分、秒 每天指定时间
日期、时、分全部屏蔽 秒 每分钟指定秒数

本课采用第三种模式,将秒设置为 10,得到每分钟第 10 秒触发一次的效果。具体使用 RTC_ALARMMASK_DATEWEEKDAY | RTC_ALARMMASK_HOURS | RTC_ALARMMASK_MINUTES,并将子秒屏蔽为 RTC_ALARMSUBSECONDMASK_ALL。

配置 RTC 时钟和中断

实验使用 STM32F407G-DISC1 开发板、STM32CubeIDE 和 STM32CubeF4 HAL 驱动。板载绿色 LD4 连接 PD12,用于显示闹钟事件。本例使用 LSI 作为 RTC 时钟,不依赖额外焊接的低速晶振。

在 STM32CubeIDE 中创建 STM32F407G-DISC1 工程,打开 .ioc 配置界面,按以下顺序设置:

  1. 在 RCC 配置中启用 LSI,并将 RTC Clock Source 选择为 LSI。
  2. 启用 RTC 日历功能,选择 24 小时制;将异步预分频设为 127、同步预分频设为 249,这是按标称 32 kHz LSI 计算的约 1 Hz 日历基准。
  3. 启用 RTC Alarm A,在 NVIC 配置中勾选 RTC Alarm interrupt,确保对应中断已使能。
  4. 将 PD12 配置为 GPIO_Output,输出类型 Push-Pull、初始电平 Low、无上下拉。
  5. 在 Project Manager 的 Code Generator 中启用为外设分别生成 .c/.h 文件的选项,生成包含 rtc.c、rtc.h、gpio.c 和 gpio.h 的工程。

如果开发板实际装有可用的 32.768 kHz LSE 晶振,生产项目优先使用 LSE,并将预分频改为异步 127、同步 255。LSI 频率随器件、温度和供电变化,适合本次触发验证,但不能据此保证精确的实际分钟长度。

生成工程后,检查 MX_RTC_Init() 初始化了 hrtc,并确认 stm32f4xx_it.c 中已经生成 RTC_Alarm_IRQHandler(),其内部调用 HAL_RTC_AlarmIRQHandler(&hrtc)。如果选择了 RTC Alarm NVIC 中断,CubeMX 通常会生成这个入口,不应另外定义同名函数。

编写每分钟触发的 Alarm A

以下为基于 CubeMX 生成工程的片段示例,适用于 STM32F4 HAL。它给出完整的 main()、闹钟配置函数和回调函数,依赖工程已有的 SystemClock_Config()、Error_Handler() 以及自动生成的 GPIO、RTC 初始化函数和中断入口。

将相关函数放入 main.c 的用户代码区域,并将主循环逻辑合并到生成的 main() 中,保留已有的时钟配置和错误处理实现,避免重复定义入口函数。

c
#include "main.h"
#include "gpio.h"
#include "rtc.h"

void SystemClock_Config(void);

static volatile uint8_t alarm_event = 0U;

void HAL_RTC_AlarmAEventCallback(RTC_HandleTypeDef *handle)
{
    // 中断回调仅发布事件,避免在中断内执行耗时操作
    if (handle->Instance == RTC) {
        alarm_event = 1U;
    }
}

static void ConfigureAlarmA(void)
{
    RTC_TimeTypeDef time = {0};
    RTC_DateTypeDef date = {0};
    RTC_AlarmTypeDef alarm = {0};

    // 仅用于可重复实验:每次启动都将日历设为固定测试时间
    time.Hours = 12U;
    time.Minutes = 0U;
    time.Seconds = 0U;
    time.DayLightSaving = RTC_DAYLIGHTSAVING_NONE;
    time.StoreOperation = RTC_STOREOPERATION_RESET;

    date.Year = 26U;
    date.Month = RTC_MONTH_JANUARY;
    date.Date = 1U;
    date.WeekDay = RTC_WEEKDAY_THURSDAY;

    if (HAL_RTC_SetTime(&hrtc, &time, RTC_FORMAT_BIN) != HAL_OK) {
        Error_Handler();
    }
    if (HAL_RTC_SetDate(&hrtc, &date, RTC_FORMAT_BIN) != HAL_OK) {
        Error_Handler();
    }

    alarm.AlarmTime.Hours = 12U;
    alarm.AlarmTime.Minutes = 0U;
    alarm.AlarmTime.Seconds = 10U;
    alarm.AlarmTime.SubSeconds = 0U;
    alarm.AlarmTime.DayLightSaving = RTC_DAYLIGHTSAVING_NONE;
    alarm.AlarmTime.StoreOperation = RTC_STOREOPERATION_RESET;

    // 屏蔽日期、小时和分钟:只比较秒数10
    alarm.AlarmMask = RTC_ALARMMASK_DATEWEEKDAY |
                      RTC_ALARMMASK_HOURS |
                      RTC_ALARMMASK_MINUTES;
    alarm.AlarmSubSecondMask = RTC_ALARMSUBSECONDMASK_ALL;
    alarm.AlarmDateWeekDaySel = RTC_ALARMDATEWEEKDAYSEL_DATE;
    alarm.AlarmDateWeekDay = 1U;
    alarm.Alarm = RTC_ALARM_A;

    // 重配闹钟前停用旧配置,再启用中断模式
    if (HAL_RTC_DeactivateAlarm(&hrtc, RTC_ALARM_A) != HAL_OK) {
        Error_Handler();
    }
    if (HAL_RTC_SetAlarm_IT(&hrtc, &alarm, RTC_FORMAT_BIN) != HAL_OK) {
        Error_Handler();
    }
}

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

    while (1) {
        if (alarm_event != 0U) {
            alarm_event = 0U;
            HAL_GPIO_TogglePin(GPIOD, GPIO_PIN_12);
        }
    }
}

预期结果:烧录并运行后,RTC 从测试时间 12:00:00 开始计数,约 10 个 RTC 秒后 LD4 由灭变亮;到 12:01:10 时由亮变灭;到 12:02:10 再次点亮。此后每经过一个 RTC 日历分钟,LED 翻转一次,不需要在回调中重新设置 Alarm。

代码使用 RTC_FORMAT_BIN,因此 10U 表示十进制 10 秒。如果改为 RTC_FORMAT_BCD,输入的时间字段也必须采用 BCD 编码。日期或小时字段虽然被屏蔽,仍为结构体填写合法值,以避免参数检查错误。

检查标志清除和重复触发

当 Alarm A 匹配时,RTC 硬件置位 RTC_FLAG_ALRAF,并使 EXTI Line 17 产生待处理中断。在 STM32F4 HAL 的 HAL_RTC_AlarmIRQHandler() 中,驱动先调用 Alarm A 回调,然后清除 RTC 的 ALRAF,最后清除 RTC Alarm 对应的 EXTI 挂起标志。

因此使用标准 HAL 中断入口时,不需要在 HAL_RTC_AlarmAEventCallback() 里再次手动清除这两个标志。尤其不要在回调中自行改写 RTC 的 ISR 寄存器,以免影响其他状态位。

可以通过调试器执行以下检查:

  1. 在 HAL_RTC_AlarmAEventCallback() 设置断点,继续运行至 12:00:10,检查回调确实进入且 handle->Instance == RTC。
  2. 在回调内观察 RTC ISR 寄存器,确认 ALRAF 已经置位。此时 HAL 中断处理器尚未执行回调后面的清标志代码。
  3. 从回调返回并执行完 HAL_RTC_AlarmIRQHandler(),观察 RTC ISR.ALRAF 和 EXTI PR 的第 17 位,确认对应挂起标志均已清除。
  4. 继续运行至 12:01:10,确认再次进入同一回调;随后观察主循环执行 LED 翻转。

预期状态为每次匹配产生一次回调,处理结束后 ALRAF=0、EXTI17 挂起位为 0,下一个匹配时刻能够再次触发。若发现立即连续进入中断,优先检查是否绕过 HAL 中断处理器或遗漏了挂起标志清除。

还可以修改 AlarmMask 做对照实验:只屏蔽 RTC_ALARMMASK_DATEWEEKDAY 时,闹钟将在每天 12:00:10 匹配;全部字段不屏蔽时,日期与时间都必须满足条件,事件不会每分钟出现。

如果只希望执行一次任务,可以在主循环处理完首次事件后调用 HAL_RTC_DeactivateAlarm(&hrtc, RTC_ALARM_A)。这样将停用 Alarm A,而不是仅清除事件标志;只清标志不会阻止未来再次满足条件。

排查不触发和异常重复

现象 优先检查 修复方式
LED 始终不变化 RTC 时钟、NVIC、IRQ 入口 确认 LSI 已启动,RTC_Alarm_IRQn 已使能,IRQ 调用了 HAL 处理器
ALRAF 已置位但无回调 EXTI17、NVIC、中断处理函数 检查 EXTI 中断路径及回调名称
回调后立即反复进中断 RTC 与 EXTI 挂起标志 使用 HAL_RTC_AlarmIRQHandler() 完成正常清除
只触发一次或间隔不符 AlarmMask 与子秒屏蔽 按每分钟比较秒数的配置重新设置 Alarm A
复位后触发时间异常 RTC 日历初始化与时钟源 读取真实时间,避免在产品程序中无条件重置日历

如果 HAL_RTC_SetAlarm_IT() 返回非 HAL_OK,还应检查所选 Alarm 是否有效、前一次写入是否完成,以及 RTC 备份域时钟是否正常。需要重新配置闹钟时,先调用 HAL_RTC_DeactivateAlarm(),确认返回成功,再写入新配置。

事件标志适用于这种低频、处理迅速的演示。若应用任务可能阻塞超过一分钟,单个布尔标志会合并多次事件;需要精确记录次数时,可在中断中维护事件计数,再由主循环逐项消费,必要时使用临界区保护共享状态。

最终验收应同时满足三个条件:指定秒数准确匹配、连续多个日历分钟都能重新触发、每次中断退出后 RTC 和 EXTI 挂起标志均被清除。这样才能区分真正的重复闹钟与未清标志造成的重复进入中断。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

通过 RTC Alarm 触发定时事件

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通