# LISA RTC 闹钟示例

## 功能说明

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

## 硬件连接

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

## 示例内容

1. 初始化 RTC 设备
2. 设置当前时间为 2025-01-15 12:00:00
3. 配置闹钟在 12:00:10 触发（10秒后）
4. 注册事件回调函数
5. 等待闹钟触发

## 编译

```{eval-rst}
.. include:: /sample_build.rst
```

## 预期输出

```
=== 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