autosar os alarm

### AUTOSAR操作系统中Alarm的使用方法

#### 设置相对时间报警器
通过`SetRelAlarm()`函数可以在相对于当前时刻的基础上设定一个延迟时间和周期性的触发间隔，从而创建一个新的定时事件。此操作会启动一个基于经过的时间来计算何时应当激活关联的任务或中断服务程序。

StatusType SetRelAlarm(
    AlarmType AlarmID, /* 报警对象 */
    TickType start,     /* 延迟多久后首次触发 (单位取决于配置) */
    TickType cycle      /* 如果是非一次性，则表示重复触发之间的间隔 */
);

该接口允许开发者定义从现在起多长时间之后发生第一次唤醒动作以及后续循环发生的频率[^1]。

#### 定义绝对时间点报警器
对于那些需要精确到具体时间节点的操作来说，`SetAbsAlarm()`提供了另一种方式——它接受两个参数分别代表期望开始的第一刻和任何连续活动间的距离。这使得应用程序能够安排未来某个确切瞬间应该做什么事情。

StatusType SetAbsAlarm(
    AlarmType AlarmID,
    TickType start,
    TickType cycle
);

这里的关键区别在于，“start”指的是自系统初始化以来已经流逝了多少个滴答声（ticks），而不是简单的等待一段时间再出发。

#### 取消已存在的闹钟
当不再希望某项预定计划被执行时，可利用`CancelAlarm()`取消之前建立起来尚未到期的所有实例。这对于动态调整运行流程非常有用，在某些情况下甚至能帮助节省资源开销。

StatusType CancelAlarm(AlarmType AlarmID);

一旦调用了这个命令，指定编号下的所有待处理提醒都将被清除掉；如果目标不存在或者已经被满足过一次以上，则不会有任何效果[^2]。

#### 查询剩余时间
为了更好地控制进程间同步状况或是实现更复杂的逻辑判断，有时还需要知道离下一个信号到来还有多少余量。此时就可以借助于`GetAlarm()`读取对应实体内部存储的状态信息了：

StatusType GetAlarm(
    AlarmType AlarmID,
    TickRefType *Tick
);

上述过程返回的是直到下一轮唤醒来临前还剩下几个基本单元长度未完成。注意这里的指针变量是用来接收实际数值而非传递给内核作为输入条件使用的。

#### 获取基础属性详情
最后一点值得注意的功能是关于如何取得有关计时装置本身的特性描述数据。比如其是否支持周期模式工作、所能容纳的最大次数限制等重要参数都可以经由下面的方法获得：

StatusType GetAlarmBase(
    AlarmType AlarmID,
    AlarmBaseRefType Info
);

这段代码片段的作用是从底层硬件抽象层提取出必要的元数据供上层软件组件参考以便做出合理的决策。