2. SWC设计与接口定义：创建灯光控制SWC、定义Runnable与Port、配置Data Type与Interface

好，咱们接着往下走。上一章我们把灯光系统的需求理清了，也搭好了DBC和BSW的架子。这一章，咱们要真正动手干点“看得见摸得着”的活——设计灯光控制SWC。

说白了，SWC就是AUTOSAR体系里的“业务逻辑单元”。你所有的控制算法、状态机、诊断处理，最后都得装进SWC里。我个人习惯，在设计SWC之前，先把接口想清楚。接口定好了，后面的代码实现就是水到渠成的事。

2.1 创建灯光控制SWC

在Vector DaVinci Developer或者EB tresos Studio里，新建一个Application SWC，名字我一般叫LightCtrl_SWC。别小看命名，我在项目中见过有人叫swc1、test_swc，等过两个月自己都看不懂了。

创建SWC时，有几个关键属性要填对：

属性	推荐值	说明
SWC Type	ApplicationSwComponentType	应用层SWC，不是ECU抽象层
Implementation	LightCtrl_Implementation	指向具体的代码实现文件
Internal Behavior	自动生成	里面会挂Runnable和Port

嗯，这里要注意：SWC本身只是一个“壳”，真正的逻辑在Internal Behavior里定义。你创建完SWC后，IDE会自动帮你生成一个Internal Behavior，你只需要往里面加东西就行。

2.2 定义Runnable——你的代码入口

Runnable是什么？说白了，就是SWC里可以被调度执行的函数。每个Runnable对应一个C函数，RTE会在特定时机调用它。

灯光控制SWC，我一般定义这么几个Runnable：

• LightCtrl_Init：初始化函数，上电时跑一次。我习惯在这里读取NVM里保存的灯光配置，比如上次的亮度设置。
• LightCtrl_MainFunction：周期运行函数，我设成10ms周期。这是核心逻辑所在——读取开关信号、判断状态、输出控制指令。
• LightCtrl_Diagnostic：诊断处理函数，事件触发。比如收到UDS诊断请求时，执行自检或读取故障码。

为什么MainFunction设10ms？我在一个项目中试过5ms，CPU负载太高；试过20ms，转向灯闪烁有延迟感。10ms是个平衡点，你想想看，人眼对50Hz以上的闪烁就不敏感了，10ms对应100Hz，绰绰有余。

2.3 定义Port——SWC与外界通信的“接口”

Port分两种：P-Port（提供端口）和R-Port（需求端口）。

P-Port是SWC对外提供数据或服务的出口。比如灯光控制SWC要输出“左转向灯亮”这个状态，就通过P-Port发出去。

R-Port是SWC从外界获取数据或服务的入口。比如读取“左转向灯开关状态”，就通过R-Port从BSW或别的SWC拿。

我设计的灯光控制SWC，端口定义如下：

端口名	类型	方向	连接对象
LightSwitch_In	R-Port	输入	Com模块（接收开关信号）
LightStatus_Out	P-Port	输出	Com模块（发送灯光状态）
LightDiag_Out	P-Port	输出	Dcm模块（诊断响应）
NvmData_In	R-Port	输入	NvM模块（读取配置）
NvmData_Out	P-Port	输出	NvM模块（保存配置）

你看，每个端口都有明确的“连接对象”。这就是AUTOSAR的好处——接口定义清楚了，谁跟谁通信一目了然。我在做集成测试时，就靠这张表来检查信号链路。

2.4 配置Data Type——别让数据类型坑了你

Data Type是AUTOSAR里最容易忽略、也最容易出问题的地方。说白了，就是定义你的信号用什么类型、什么取值范围。

灯光控制涉及的数据类型，我一般这么配：

• LightSwitchType：枚举类型，取值OFF、LOW_BEAM、HIGH_BEAM、TURN_LEFT、TURN_RIGHT。底层用uint8表示。
• LightStatusType：结构体，包含所有灯光的状态位。比如左转向灯、右转向灯、近光灯、远光灯、雾灯等，每个占1 bit。
• BrightnessLevel：uint8，0~100，表示亮度百分比。我遇到过有人用float，结果RTE不支持浮点传输，折腾了半天。

2.5 配置Interface——把Port和DataType串起来

Interface就是Port和DataType之间的“桥梁”。你定义了Port，也定义了DataType，但得告诉工具：这个Port用哪个DataType。

我一般创建两种Interface：

• SenderReceiverInterface：用于数据通信。比如LightStatus_Out端口，用LightStatus_IF这个Interface，里面包含LightStatusType这个数据元素。
• ClientServerInterface：用于函数调用。比如诊断接口，定义成LightDiag_IF，里面包含SelfTest()、GetFaultCode()等操作。

配置Interface时，有个细节要注意：数据元素的名字要和信号名保持一致。比如CAN报文里信号叫LeftTurnLight_St，那Interface里的数据元素最好也叫这个。这样生成代码时，RTE会自动帮你做映射，省去手动配置的麻烦。

嗯，这里我再多说一句。Interface的命名规范也很重要。我见过有人叫IF1、IF2，等代码生成出来，根本分不清哪个是哪个。我个人的习惯是：模块名_功能_IF，比如LightCtrl_Status_IF，一目了然。

2.6 小结一下

这一章的内容，说白了就是三件事：

1. 创建SWC，定义Runnable（你的代码入口）
2. 定义Port（通信的“插座”）
3. 配置DataType和Interface（把“插座”和“插头”匹配好）

这三件事做扎实了，后面的代码实现就是填空。我在项目中见过太多人，一上来就写代码，结果接口没想清楚，后面改得死去活来。你想想看，是不是这个理？

下一章，咱们要真正写代码了——实现灯光控制逻辑，包括状态机、PWM控制、诊断处理。到时候我会把完整的代码贴出来，咱们一行一行地过。