autosar os alarms

### AUTOSAR操作系统中的Alarms配置与使用

#### Alarms概述
在AUTOSAR操作系统中，alarms用于实现周期性和一次性事件的时间管理功能。通过定义特定时间间隔的任务触发条件，可以精确控制应用程序的行为和调度[^1]。

#### Alarm结构体成员变量说明
Alarm由一系列参数构成，这些参数决定了alarm行为特性：

- `name`: alarm对象名称，在整个应用范围内唯一标识该定时器实例；
- `action`: 当alarm到期时执行的动作类型（如激活任务、设置事件等）；
- `cycleTime`: 如果是周期性的，则表示两次连续触发之间的时间长度；如果是单次触发则此字段无意义；
- `offsetTime`: 定义了从启动时刻到第一次触发所需等待的时间量；
- `priority`: 可选属性，指定当多个alarms同时发生冲突情况下优先级较高的会被先处理。

#### 创建和初始化Alarm
为了创建一个新的alarm实体并将其加入内核管理列表之中，需调用`OsCreateAlarm()`函数完成资源分配工作，并传入上述提到的相关配置项作为输入参数来描述新建立的对象特征。

// 示例代码片段展示如何声明以及初始化一个alarm
const Os_alarmType MyPeriodicTaskAlarm = {
    .name        = "MyPeriodicTask",
    .action      = ALARM_ACTION_ACTIVATE_TASK,
    .taskRef     = &MyTask,          /* 被激活的任务引用 */
    .cycleTime   = 100U,             /* 周期时间为100毫秒 */
    .offsetTime  = 50U               /* 初始偏移为50毫秒 */
};

#### 启动/停止Alarm操作
一旦完成了alarm的设定之后就可以利用API接口对其进行启停控制了。“开启”意味着让其按照预设规则开始计数直至达到预定时间节点从而引发相应动作的发生；而“关闭”的含义则是中断当前正在进行中的倒计过程使之不再继续向前推进直到再次被显式唤醒为止。

/* 开始或重启已存在的alarm */
void StartOrRestartAlarm(void){
    (void)OsStartAlarm(&MyPeriodicTaskAlarm);
}

/* 终止正在运行状态下的alarm */
void StopRunningAlarm(void){
    (void)OsStopAlarm(&MyPeriodicTaskAlarm);
}