📚 课程目录第3章应用层（ASW）设计

3、应用层（ASW）设计：SWC类型与接口、Runnable与触发事件、端口与连接、内部行为与实现

应用层设计，说白了就是定义你的软件到底要干什么。在AUTOSAR里，这一层叫ASW（Application Software），它不关心底层硬件怎么跑，只关心业务逻辑。我刚开始接触AUTOSAR时，总觉得这层太抽象，后来才发现，把ASW设计清楚了，整个项目就稳了一半。

3.1 SWC类型与接口

SWC（Software Component）是ASW的基本单元。你可以把它想象成一个“黑盒子”，它有自己的输入输出，内部封装了具体的功能逻辑。AUTOSAR定义了两种主要的SWC类型：

SWC类型	说明	典型场景
Atomic SWC	原子级组件，不可再分。一个SWC对应一个ECU上的一个功能模块。	车窗控制、雨刮控制、座椅调节
Composition SWC	组合组件，由多个Atomic SWC或其它Composition SWC组成。用于系统级建模。	车身域控制器、智能座舱域控制器

我的经验： 在实际项目中，我习惯把每个独立的功能单元设计成一个Atomic SWC。比如一个“自动大灯”功能，我会拆成“光照传感器采集”、“光线阈值判断”、“大灯控制输出”三个Atomic SWC。这样每个SWC的职责单一，测试和复用都方便。

SWC通过端口（Port）与外界交互。端口分为两种：

提供端口（PPort）：SWC对外提供数据或服务。比如“大灯控制输出”SWC提供一个PPort，用于设置大灯开关状态。
需求端口（RPort）：SWC需要从外部获取数据或服务。比如“光照传感器采集”SWC需要一个RPort，用来读取传感器的原始值。

端口上定义的是接口（Interface）。接口是SWC之间通信的契约。AUTOSAR定义了三种接口：

Sender-Receiver Interface（S/R接口）：用于数据流通信。一个SWC发送数据，一个或多个SWC接收数据。比如车速信号、发动机转速信号。
Client-Server Interface（C/S接口）：用于操作调用。一个SWC作为Server提供某个操作（如“计算油耗”），另一个SWC作为Client调用这个操作。
Mode Switch Interface（模式切换接口）：用于模式管理。比如“点火开关”从OFF切换到ON，会触发一系列SWC的模式切换。

    避坑指南： 我曾经在一个项目中，把S/R接口和C/S接口混用。明明是个数据流，却设计成了C/S调用，结果导致通信开销大增，调度也出了问题。记住：数据流用S/R，操作调用用C/S，别混。

3.2 Runnable与触发事件

SWC内部封装的是Runnable。Runnable就是一段可执行的代码，你可以把它理解成一个函数。每个Runnable都有一个触发事件（Trigger Event），告诉RTE（Runtime Environment）什么时候该执行这个Runnable。

常见的触发事件类型：

触发事件	说明	典型Runnable
Timing Event	周期性触发，比如每10ms执行一次。	传感器数据采集、控制周期计算
Data Received Event	当某个端口接收到新数据时触发。	信号处理、数据校验
Operation Invoked Event	当Client调用某个Server操作时触发。	服务端处理函数
Mode Switch Event	当系统模式发生变化时触发。	模式切换初始化、状态机更新
Init Event	SWC初始化时触发一次。	变量初始化、硬件配置

注意： 一个SWC可以包含多个Runnable，每个Runnable可以绑定不同的触发事件。但同一个Runnable不能绑定多个触发事件。如果你需要多个条件触发同一段逻辑，可以考虑用“组合事件”或者把逻辑拆成多个Runnable。

举个例子，一个“车窗防夹”SWC，我通常会设计三个Runnable：

Runnable_Init：绑定Init Event，初始化车窗位置和电流阈值。
Runnable_Monitor：绑定Timing Event（5ms周期），实时监测电机电流。
Runnable_Handle：绑定Data Received Event，当接收到“车窗开关信号”时，执行防夹逻辑。

3.3 端口与连接

端口是SWC的“触角”，连接是端口之间的“桥梁”。在AUTOSAR中，端口连接是通过Assembly Connector和Delegation Connector实现的。

Assembly Connector：用于连接同一个Composition内部的两个Atomic SWC的端口。比如“光照传感器采集”SWC的PPort连接到“光线阈值判断”SWC的RPort。
Delegation Connector：用于将Composition SWC的端口委托给内部的某个Atomic SWC的端口。比如Composition SWC的某个PPort，实际上是由内部某个Atomic SWC的PPort提供的。

连接时，端口上的接口必须匹配。S/R接口只能连接S/R接口，C/S接口只能连接C/S接口。接口的数据元素（Data Element）或操作（Operation）也必须一致。

我的习惯： 在设计端口连接时，我会先画一个“SWC通信图”，把每个SWC的端口和连接关系画出来。这样能直观地看到数据流和控制流，避免遗漏或冗余连接。我曾经在一个项目中，因为漏画了一个连接，导致两个SWC之间通信失败，排查了整整两天。

3.4 内部行为与实现

内部行为（Internal Behavior）是SWC的“灵魂”。它定义了SWC内部的所有Runnable、触发事件、端口映射、以及内部变量。说白了，就是告诉RTE：这个SWC到底怎么跑。

内部行为的主要元素：

Runnable映射：每个Runnable绑定到哪个触发事件。
端口访问：Runnable通过哪些端口读写数据或调用操作。
内部变量：SWC内部使用的全局变量或静态变量。
等待点（Wait Point）：Runnable可以设置等待点，让RTE在特定条件下暂停或恢复执行。

实现层面，Runnable的代码通常由开发者手动编写。AUTOSAR只定义了接口和框架，具体的业务逻辑还是得你来写。比如：

/* Runnable: Runnable_Monitor */
/* 触发事件: Timing Event (5ms) */
/* 功能: 监测电机电流，判断是否防夹 */

FUNC(void, AUTOMATIC) Runnable_Monitor(void)
{
    uint16 current = 0;
    /* 通过RPort读取电机电流 */
    Rte_Read_RPort_Current(&current);

    /* 判断是否超过防夹阈值 */
    if (current > PINCH_THRESHOLD)
    {
        /* 通过PPort发送停止指令 */
        Rte_Write_PPort_StopCmd(1);
    }
}

    关键点： Runnable的代码不能直接调用其他SWC的函数，必须通过RTE提供的API（如Rte_Read、Rte_Write、Rte_Call）来访问端口。这是AUTOSAR的核心约束，保证了SWC的独立性和可移植性。

下面这张图展示了ASW层从SWC到Runnable再到端口连接的完整结构：

嗯，到这里，ASW层设计的基本概念就讲完了。你想想看，SWC、Runnable、端口、连接，这些元素组合起来，就能构建出任意复杂的应用逻辑。我个人觉得，ASW设计的关键在于“分而治之”——把大功能拆成小SWC，每个SWC只做一件事，然后通过端口和连接把它们组合起来。这样设计出来的系统，既清晰又灵活。