单片机与物联网 / 系统课时
通过 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()。回调只通知应用发生了事件,耗时任务应放在主循环执行。

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 配置界面,按以下顺序设置:
- 在 RCC 配置中启用 LSI,并将 RTC Clock Source 选择为 LSI。
- 启用 RTC 日历功能,选择 24 小时制;将异步预分频设为
127、同步预分频设为249,这是按标称 32 kHz LSI 计算的约 1 Hz 日历基准。 - 启用 RTC Alarm A,在 NVIC 配置中勾选
RTC Alarm interrupt,确保对应中断已使能。 - 将 PD12 配置为
GPIO_Output,输出类型 Push-Pull、初始电平 Low、无上下拉。 - 在 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() 中,保留已有的时钟配置和错误处理实现,避免重复定义入口函数。
#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 寄存器,以免影响其他状态位。
可以通过调试器执行以下检查:
- 在
HAL_RTC_AlarmAEventCallback()设置断点,继续运行至12:00:10,检查回调确实进入且handle->Instance == RTC。 - 在回调内观察 RTC
ISR寄存器,确认ALRAF已经置位。此时 HAL 中断处理器尚未执行回调后面的清标志代码。 - 从回调返回并执行完
HAL_RTC_AlarmIRQHandler(),观察 RTCISR.ALRAF和 EXTIPR的第 17 位,确认对应挂起标志均已清除。 - 继续运行至
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 挂起标志均被清除。这样才能区分真正的重复闹钟与未清标志造成的重复进入中断。