3. SWC设计基础：创建SWC、定义端口、配置数据类型、SWC内部行为

好，咱们正式开始动手了。这一章是SWC设计的核心基础，说白了就是教你如何在DaVinci Config里把一个软件组件从无到有地搭起来。我个人觉得，这部分学扎实了，后面那些复杂的通信、调度、模式管理，你上手会快很多。

3.1 创建SWC：你的第一个组件

打开DaVinci Config Developer，新建一个项目后，第一件事就是创建SWC。嗯，这里要注意，SWC的类型有好几种，但咱们最常用的是Application SWC。

操作路径很简单：在Component树里右键 -> New -> Application SwComponentType。然后给它起个名字。我习惯用「模块名_Swc」这种命名方式，比如DoorLock_Swc，清晰明了。

创建完成后，你会看到SWC的编辑界面。这里有几个关键属性需要配置：

• Short Name：组件名称，建议用英文大写驼峰
• Swc Implementation：指向具体的实现代码文件（.c/.h）
• Is Service：一般保持False，除非你是在做BSW服务

3.2 定义端口（Port）：让组件跟外界说话

SWC创建好了，但它是个孤岛。怎么跟其他组件通信？靠端口。端口分两种：提供端口（PPort）和需求端口（RPort）。你想想看，这就像你家的插座——PPort是插头，往外送电；RPort是插座，从外面取电。

创建端口的方法：在SWC上右键 -> New -> Port。然后选择端口方向：

端口类型	方向	典型用途
PPort	提供数据/服务	传感器值、执行器控制
RPort	请求数据/服务	读取其他组件的状态
PRPort	双向	较少用，复杂通信场景

定义端口时，最关键的是给它绑定一个接口（Interface）。接口定义了端口能传输哪些数据、提供哪些操作。我个人建议，接口命名用「模块名_Interface」的格式，方便后期维护。

3.3 配置数据类型（Data Type）：给数据穿上衣服

端口定义好了，但端口上传什么数据？这就涉及到数据类型。AUTOSAR的数据类型体系有点复杂，但咱们先从最常用的开始：Implementation Data Type（IDT）和Application Data Type（ADT）。

简单说：

• IDT：直接映射到C语言基本类型，比如uint8、uint16、float32
• ADT：带语义的数据类型，比如车速、温度、开关状态

创建数据类型的步骤：在Data Type树里右键 -> New -> Implementation Data Type。然后设置它的Base Type，比如选择uint8，再设置Min和Max范围。

举个例子，定义一个「车门状态」的数据类型：

// 在DaVinci中配置
Short Name: DoorStatus_IDT
Base Type: uint8
Min: 0
Max: 3
// 语义映射：
// 0 = 关闭
// 1 = 打开
// 2 = 半开
// 3 = 故障

为什么这么做？因为AUTOSAR要求数据类型必须显式定义，不能直接用C语言的int。这样做的好处是——不同ECU之间数据交换时，大家知道这个数据到底占几个字节、范围是多少。说白了，就是防止「鸡同鸭讲」。

3.4 SWC内部行为（Runnable）：组件的大脑

端口和数据都准备好了，但SWC怎么工作？靠Runnable。Runnable就是一段可执行的代码，它被调度器周期性或事件触发地调用。你可以把它理解成SWC里的「函数」。

创建Runnable：在SWC的Internal Behavior里右键 -> New -> Runnable Entity。然后配置它的触发方式：

• 周期性触发：设置周期时间，比如10ms、100ms
• 事件触发：比如数据到达、模式切换
• 初始化触发：系统启动时执行一次

我一般会这样设计：

// 一个典型的SWC内部行为
Runnable: DoorLock_MainFunction
  Trigger: 周期性 10ms
  功能：读取门锁状态、判断是否要上锁/解锁

Runnable: DoorLock_InitFunction
  Trigger: 初始化
  功能：初始化硬件、设置默认状态

Runnable: DoorLock_DataReceived
  Trigger: 事件（当遥控信号到达时）
  功能：解析遥控指令、执行开锁/关锁

每个Runnable都需要绑定一个C函数名。这个函数名会出现在生成的RTE代码中，你需要在手写的.c文件里实现它。

3.5 完整示例：一个简单的车门控制SWC

咱们把上面学的串起来，做一个完整的车门控制SWC。假设需求是：

• 读取门锁开关状态
• 接收遥控解锁信号
• 控制门锁电机

配置步骤：

1. 创建SWC：DoorControl_Swc
2. 定义端口：
   • RPort：LockStatus_RPort（读取门锁状态）
   • RPort：RemoteSignal_RPort（接收遥控信号）
   • PPort：MotorControl_PPort（控制电机）
3. 配置数据类型：
   • LockStatus_IDT：uint8，0=解锁，1=锁定
   • MotorCmd_IDT：uint8，0=停止，1=正转，2=反转
4. 创建Runnable：
   • DoorControl_10ms：周期性执行，读取状态并控制电机
   • DoorControl_RemoteHandler：事件触发，处理遥控信号

配置完成后，DaVinci会生成RTE代码。你只需要在DoorControl_10ms对应的C函数里写业务逻辑就行。嗯，这里要注意，RTE生成的代码里，端口数据是通过Rte_Read_xxx和Rte_Write_xxx接口来访问的，别直接操作全局变量。

好了，这一章的内容就到这儿。下一章咱们聊聊端口接口的深入配置，包括Client-Server通信和Mode Switch端口。到时候你会发现，SWC之间的通信方式比你想的丰富得多。