Matlab AutoSAR开发实战:从零开始构建SWC与Runable(附完整代码示例)
如果你是一名汽车电子领域的工程师,最近被AutoSAR(汽车开放系统架构)搞得有点头大,特别是面对Matlab/Simulink这个强大的工具却不知如何下手,那么这篇文章就是为你准备的。我刚开始接触AutoSAR时,也经历过同样的困惑:文档看了不少,概念也懂了一些,但一打开Simulink,面对空白的画布,还是不知道第一块模块该往哪里放。那种理论与实践的断层感非常强烈。本文将彻底打破这种断层,我将以一个真实的、可运行的示例为线索,带你从零开始,一步步在Matulab中构建一个完整的软件组件(SWC),并实现其内部的运行实体(Runable)。整个过程不仅仅是点击按钮,我会穿插大量实际操作中的“坑点”和“技巧”,并附上可直接复用的代码片段,确保你读完就能动手,动手就能出结果。我们的目标不是成为理论家,而是能交付代码的实战派。
1. 环境准备与项目初始化
在开始任何建模工作之前,一个正确且高效的环境是成功的基石。很多初学者容易忽略这一步,直接新建模型,导致后续配置混乱,甚至无法生成符合AutoSAR标准的代码。我们将系统性地完成准备工作。
首先,确保你的Matlab版本支持AutoSAR Blockset。通常,这需要专门的工具箱授权。打开Matlab后,你可以在命令窗口输入 ver 来查看已安装的工具箱列表,确认‘AUTOSAR Blockset’是否存在。
注意:不同版本的Matlab和AutoSAR Blockset支持的AUTOSAR标准版本(如AR4.2, AR4.4)可能不同,请根据你的项目需求进行匹配。本文示例基于较通用的AR4.3风格。
接下来,我们不是直接新建一个普通的Simulink模型,而是通过更规范的方式创建项目。虽然直接新建.slx文件也可以,但使用“项目”功能可以更好地管理依赖、路径和设置。不过,为了最直观地演示,我们从基础步骤开始:
- 新建模型并保存:在Matlab主页点击“Simulink”,选择“Blank Model”。立即将其保存到一个英文路径且无空格的目录下,例如
D:\Projects\MyFirstSWC\DemoSWC.slx。这一步看似简单,但路径中的中文字符或空格可能在后续代码生成时引发意想不到的错误。 - 关键模型配置:双击画布空白处,注意力不要被模块吸引,先打开“Model Settings”(快捷键Ctrl+E)。这里有几个生死攸关的配置:
- 求解器(Solver):AutoSAR是实时系统,必须使用固定步长(Fixed-step) 离散求解器。在“Solver”选项卡中,进行如下设置:
Type: Fixed-step Solver: discrete (no continuous states) Fixed-step size (fundamental sample time): 0.01 (或你的系统基准周期,如0.001) - 系统目标文件(System target file):这是告诉Matlab生成何种代码的核心。在“Code Generation”部分,点击“Browse”,选择
autosar.tlc。如果列表中没有,说明AutoSAR Blockset未正确安装。 - 启用AUTOSAR支持:在“Code Generation”的“Interface”子选项卡下,确保“Code interface packaging”设置为“Nonreusable function”,并勾选“Generate AUTOSAR-compliant code”或类似选项(不同版本表述略有差异)。这一步会激活很多AutoSAR专属的配置项。
- 求解器(Solver):AutoSAR是实时系统,必须使用固定步长(Fixed-step) 离散求解器。在“Solver”选项卡中,进行如下设置:
完成这些后,你的模型骨架才算准备就绪。此时,模型还是一个“空壳”,不具备任何AutoSAR属性。我们需要将其“转换”或“声明”为一个AutoSAR软件组件。
2. 将Simulink模型定义为AutoSAR SWC
一个Simulink模型文件(.slx)本质上可以对应一个AutoSAR软件组件(SWC)。我们需要通过AutoSAR工具链来建立这种映射关系并配置组件的元信息。
在Simulink的“APPS”选项卡中,找到并点击“AUTOSAR”。这通常会打开两个核心界面:Code Mapping Editor(代码映射编辑器)和AUTOSAR Dictionary(AUTOSAR字典)。后者是SWC的“身份证”和“户口本”。
首先在AUTOSAR Dictionary中创建组件:
- 点击“Add”或“New”,选择“Software Composition”。
- 在弹出的向导中,你需要为你的SWC命名,例如
DemoSWC。遵循命名约定,通常使用驼峰式或带下划线的清晰名称。 - 一路“Next”,你可以配置组件的类型(Application/SensorActuator等)、描述等信息。对于初学者,大部分默认设置即可,但请留意一个关键点:组件类型。这会影响后续可用的接口类型。我们这里选择最常见的
Application。
创建完成后,回到Simulink画布,你会发现似乎没什么变化。别急,打开Code Mapping Editor,在“AUTOSAR Software Component”下拉菜单中,应该能看到你刚创建的 DemoSWC 已经被关联上了。至此,这个Simulink模型就正式被定义为一个名为 DemoSWC 的AutoSAR应用软件组件了。
提示:AUTOSAR Dictionary是一个独立的XML风格数据库,它存储了SWC的所有元数据(接口、端口、内部行为等),与Simulink模型是分离又关联的。理解这种“模型-元数据”分离的架构,对后续调试非常重要。
3. 创建与实现Runable(运行实体)
Runable是SWC内部可调度的最小代码单元,可以理解为C语言中的函数。在Simulink中,Function-Call Subsystem(函数调用子系统)是Runable的物理载体。我们将创建两个典型的Runable:一个初始化Runable(Init)和一个周期性Runable(Main)。
3.1 在元数据层定义Runable
在Simulink中画子系统之前,我们需要先在AUTOSAR字典中声明它们的存在。这体现了AutoSAR“设计先于实现”的思想。
- 在AUTOSAR Dictionary中,导航到
DemoSWC->Internal Behavior。 - 右键点击
Runnables,选择“Add Runnable”。我们创建第一个:- Name:
DemoSWC_Init - Symbol:
DemoSWC_Init(通常与Name一致,是生成的函数名) - Type:
Init(初始化运行实体)
- Name:
- 同理,再添加一个周期性Runable:
- Name:
DemoSWC_Main - Symbol:
DemoSWC_Main - Type:
TimingEvent(由定时事件触发)
- Name:
现在,我们有了两个“空壳”Runable。它们还需要被“触发”。对于 DemoSWC_Init,我们需要为其分配一个初始化事件(InitializeEvent)。对于 DemoSWC_Main,则需要分配一个定时事件(TimingEvent),并指定其周期。
在AUTOSAR Dictionary的 Events 节点下:
- 为
DemoSWC_Init创建一个InitializeEvent。 - 为
DemoSWC_Main创建一个TimingEvent,并将其周期(Period)设置为模型的基础采样时间,例如0.01秒。
3.2 在Simulink中实现Runable功能
现在,回到Simulink画布,实现这两个Runable的功能。
- 创建Init Runable:
- 从库浏览器(Library Browser)中,找到“Ports & Subsystems”库,拖拽一个 Function-Call Subsystem 到模型中。
- 双击子系统进入,删除自带的
Trigger端口。初始化Runable不需要触发端口,它由系统自动调用一次。 - 在里面实现你的初始化逻辑。例如,我们可以添加一个Constant模块(值为1)连接到一个Outport,命名为
InitOut。这个简单的逻辑表示初始化完成并设置一个初始状态。 - 将子系统命名为
DemoSWC_Init,以保持清晰。
- 创建Main Runable:
- 再拖拽一个 Function-Call Subsystem 到主画布。
- 这次保留其
Function-Call Trigger端口。这个端口将接收来自定时事件的调用。 - 在内部实现周期性执行的算法。例如,添加一个Inport
SensorIn,一个Gain模块(增益为2),连接到一个OutportActuatorOut。这模拟了一个简单的信号处理过程。 - 将子系统命名为
DemoSWC_Main。
3.3 关键的映射(Mapping)步骤
这是连接“元数据”和“实现”的桥梁,也是最容易出错的一步。打开 Code Mapping Editor。
- 切换到“Functions”选项卡。
- 在左侧的“Simulink Entry-Point Functions”列表中,你应该能看到你的两个Function-Call Subsystem。
- 将
DemoSWC_Init子系统映射到AUTOSAR RunnableDemoSWC_Init。同时,在“Events”列,将其关联到之前创建的InitializeEvent。 - 将
DemoSWC_Main子系统映射到AUTOSAR RunnableDemoSWC_Main,并将其事件关联到对应的TimingEvent。
完成映射后,Code Mapping Editor中的对应行会显示绿色的对勾或清晰的链接标识。这一步确保了在生成代码时,Simulink子系统内的算法会被正确包装成对应的AutoSAR Runnable函数。
4. 设计接口(Interface)与端口(Port)
SWC不可能孤立存在,它必须通过端口(Port)和接口(Interface)与外界(其他SWC或基础软件)通信。接口定义了数据的“类型”,端口则是组件的“插槽”。
4.1 创建Sender-Receiver接口
假设我们的 DemoSWC_Main 需要接收一个传感器信号,并输出一个处理后的执行器信号。这需要使用Sender-Receiver(S-R)接口。
-
在AUTOSAR Dictionary中创建接口:
- 导航到
Interfaces节点,右键创建新的SenderReceiverInterface,命名为SensorData_If。 - 在该接口下,创建一个
DataElement,命名为RawValue,并设置其类型(uint16)和初始值。 - 同理,创建另一个接口
ActuatorData_If,包含一个DataElement命名为CmdValue(uint16类型)。
- 导航到
-
创建端口并关联接口:
- 在AUTOSAR Dictionary中,找到
DemoSWC->Ports。 - 创建一个
Requester Port(需要数据端口),命名为SensorPort,类型选择SenderReceiverInterface,并关联到SensorData_If。这表示本组件从这个端口“接收”数据。 - 创建一个
Provider Port(提供数据端口),命名为ActuatorPort,同样关联到ActuatorData_If。这表示本组件从这个端口“发送”数据。
- 在AUTOSAR Dictionary中,找到
4.2 在Simulink中连接端口与Runable
现在,我们需要在Simulink模型中实例化这些端口,并将其与Runable内部的信号连接起来。
- 在主模型画布,为
DemoSWC_Main这个Function-Call Subsystem添加一个输入端口和一个输出端口(不是修改子系统内部,而是在主画布上点击该子系统,使用菜单或右键菜单添加Inport/Outport)。 - 分别将这两个端口命名为
SensorPort和ActuatorPort,以与AUTOSAR端口名对应。 - 再次进行映射:打开Code Mapping Editor,切换到“Inports”和“Outports”选项卡。
- 将Simulink Inport
SensorPort映射到AUTOSAR PortSensorPort,并指定其对应的DataElement为RawValue。 - 将Simulink Outport
ActuatorPort映射到AUTOSAR PortActuatorPort,并指定其对应的DataElement为CmdValue。
- 将Simulink Inport
至此,一个完整的数据流链路就建立了:外部数据通过 SensorPort (S-R接口) 进入SWC,传递给 DemoSWC_Main Runable进行处理,处理结果通过 ActuatorPort (S-R接口) 发送出去。
为了更清晰地对比,我们将关键元素总结如下表:
| 元素类型 | AutoSAR 概念 (元数据) | Simulink 实现 (模型) | 映射关系 |
|---|---|---|---|
| 组件 | Software Component: DemoSWC | Simulink Model: DemoSWC.slx | 通过AUTOSAR Dictionary关联 |
| 运行实体 | Runnable: DemoSWC_Init, DemoSWC_Main | Function-Call Subsystem | 在Code Mapping的Functions选项卡映射 |
| 触发事件 | InitializeEvent, TimingEvent (Period=0.01s) | (无直接模块,由配置决定) | 在Code Mapping中关联到Runnable |
| 接口 | SenderReceiverInterface: SensorData_If | (无直接模块,是数据类型定义) | - |
| 数据元素 | DataElement: RawValue (uint16) | Simulink信号的数据类型 | 在Port映射时指定 |
| 端口 | Requester Port: SensorPort | Simulink Inport Block | 在Code Mapping的Inports/Outports选项卡映射 |
5. 代码生成与验证
所有配置和建模完成后,激动人心的代码生成环节到了。点击Simulink工具栏的“Build”按钮(或按Ctrl+B)。如果一切配置正确,Matlab将开始编译模型并生成AutoSAR格式的C代码。
生成成功后,重点关注 DemoSWC_ert_rtw 文件夹(具体文件夹名可能因配置而异)中的内容。你会找到几个关键文件:
DemoSWC.c/DemoSWC.h: 这是组件的主文件,包含了Runnable的函数声明和组件生命周期接口。DemoSWC_Init.c/DemoSWC_Main.c: 这里包含了你的算法代码。打开DemoSWC_Main.c,你应该能看到类似下面的函数:void DemoSWC_Main(void) { /* 从端口读取数据 */ uint16_T SensorPort_RawValue = Rte_IRead_DemoSWC_Main_SensorPort_RawValue(); /* 算法核心(你的Gain*2) */ uint16_T ActuatorPort_CmdValue = SensorPort_RawValue * 2; /* 向端口写入数据 */ Rte_IWrite_DemoSWC_Main_ActuatorPort_CmdValue(ActuatorPort_CmdValue); }Rte_DemoSWC.h: 运行时环境(RTE)接口头文件,包含了数据读写的宏定义。
注意:生成的代码中,数据访问都通过
Rte_IRead_*和Rte_IWrite_*这样的RTE接口进行。这是AutoSAR分层架构的关键,实现了SWC与底层通信机制的隔离。
验证生成代码的正确性后,你可以将其集成到你的AutoSAR工程中,与其他组件一起进行编译、链接和部署。这个过程虽然在本教程之外,但你已经拥有了一个完全符合AutoSAR标准、功能清晰的软件组件模块。
整个流程走下来,你会发现AutoSAR开发在Matlab中更像是一种“声明式”建模。我们花费了大量时间在配置和映射上,而实际的算法逻辑只占了一小部分。这正是AutoSAR追求的目标:通过标准化和工具链,将工程师从底层通信细节中解放出来,更专注于功能实现。第一次操作可能会觉得繁琐,但形成习惯后,这套流程能极大地提升复杂系统开发的效率和可靠性。我在多个量产项目中都沿用类似的起步流程,它帮我规避了无数初期集成阶段的低级错误。下次,我们可以聊聊如何为这个SWC添加模式管理(Mode Switch)或更复杂的客户端-服务器(C-S)接口。
3307



被折叠的 条评论
为什么被折叠?



