LISA RTC 闹钟示例

功能说明

本示例演示如何使用 LISA RTC 驱动的闹钟功能。

硬件连接

无需外部连接,RTC 为芯片内部外设。

示例内容

  1. 初始化 RTC 设备

  2. 设置当前时间为 2025-01-15 12:00:00

  3. 配置闹钟在 12:00:10 触发(10秒后)

  4. 注册事件回调函数

  5. 等待闹钟触发

编译

重要提示:在编译前,请先确认您使用的开发板型号。SDK 目前支持以下开发板:

  • arcs_evb - ARCS EVB 评估板

  • arcs_mini - ARCS Mini 开发板

根据您的开发板型号,选择对应的编译命令:

在示例目录下执行编译:

# 使用 arcs_evb 开发板
./build.sh -C -DBOARD=arcs_evb

# 或使用 arcs_mini 开发板
./build.sh -C -DBOARD=arcs_mini

Note

如果在 SDK 根目录执行,需要指定示例路径:

# 使用 arcs_evb 开发板
./build.sh -C -S samples/<示例路径> -DBOARD=arcs_evb

# 或使用 arcs_mini 开发板
./build.sh -C -S samples/<示例路径> -DBOARD=arcs_mini

Note

确保已安装对应的工具链。

预期输出

=== LISA RTC alarm example ===
rtc0 device ready
RTC time set: 2025-01-15 12:00:00
Alarm set: 12:00:10
Alarm enabled, waiting for trigger...
Current time: 2025-01-15 12:00:00
Current time: 2025-01-15 12:00:01
Current time: 2025-01-15 12:00:02
...
Current time: 2025-01-15 12:00:09
Current time: 2025-01-15 12:00:10
Alarm triggered!
Alarm test completed!

参数说明

  • 设备名称: rtc0

  • 初始时间: 2025-01-15 Wednesday 12:00:00

  • 闹钟时间: 12:00:10 (10秒后)

  • 闹钟匹配: 支持年/月/日/时/分/秒多级匹配

注意事项

  1. 闹钟匹配: ⚠️ ARCS CALENDAR 闹钟需要所有字段都匹配

    • 必须设置完整的年/月/日/时/分/秒

    • 不支持忽略字段(即使设为 0 也会参与匹配)

    • 如果只想在每天某个时间触发,需要每天重新设置闹钟

  2. 年份范围: 0-127

  3. 中断回调: 回调在中断上下文中执行,应保持简短

  4. 闹钟ID: 当前仅支持 1 个闹钟,ID 固定为 0