RTC 外设示例

平台	目标
lm620	r4f4

演示 RTC 外设的时间读取、时间戳获取和闹钟功能。

预期行为

**时间读取**：

• 等待 1 秒后（确保系统已设置 RTC 时间），调用 xt_hal_rtc_get_time() 获取当前时间
• 调用 xt_hal_rtc_get_timestamp() 获取 Unix 时间戳
• 串口输出当前日期时间：

[00000000][example_task]: RTC HAL example start
[000003E8] Get time: 2025-10-28 14:30:00
[000003E8] Get timestamp: 1761633000

**闹钟设置**：

• 在当前时间基础上偏移 3 秒设置闹钟，并注册回调 rtc_alarm_callback
• 回读闹钟时间验证设置正确
• 闹钟触发时，回调打印闹钟 ID、事件、累计触发次数和系统 tick

**定时输出**：

• 主循环每 10 秒打印一次当前时间、时间戳和闹钟累计触发次数：

[00000000] Alarm 0 setup ret=0, target: 14:30:03
[00000000] Get alarm 0: 14:30:03
[ALARM] id=0, event=0, total_count=1, tick=00000FA0
[00002710] Current: 14:30:10, TS: 1761633010, Alarms: 1
[00004E20] Current: 14:30:20, TS: 1761633020, Alarms: 3

编译和运行

cd examples/peripherals/rtc
xt --target lm620/r4f4 fullclean build

下载固件后运行，串口观察 RTC 时间和闹钟回调日志。

注意事项

• 示例假设系统已由其他程序设置 RTC 时间，不主动调用 xt_hal_rtc_set_time() （代码中已 #if 0 禁用）
• 闹钟设置为一次性触发（触发后需重新设置才能再次触发），但 RTC 每秒回绕可能导致重复回调
• 此示例不依赖 xt_board（板级配置） ，可直接编译运行，无需指定 --board