4. 端口接口（PortInterface）：四种接口的定义与选择

好，咱们今天聊聊端口接口。说实话，这是SWC设计里最基础也最容易搞混的一块。我见过不少项目，因为接口类型选错了，后期改得那叫一个痛苦。今天我就把四种接口掰开揉碎了讲清楚。

4.1 SenderReceiverInterface（发送-接收接口）

这个接口，说白了就是数据发布。一个SWC发数据，另一个SWC收数据。有点像广播电台——你只管播，谁爱听谁听。

什么时候用？

• 传感器数据传递（车速、温度、压力）
• 状态信息共享（系统模式、故障码）
• 周期性数据更新

// ARXML 示例片段
<SENDER-RECEIVER-INTERFACE UUID="...">
  <SHORT-NAME>VehicleSpeed_I</SHORT-NAME>
  <IS-SERVICE>false</IS-SERVICE>
  <DATA-ELEMENTS>
    <VARIABLE-DATA-PROTOTYPE>
      <SHORT-NAME>SpeedValue</SHORT-NAME>
      <TYPE-TREF DEST="SW-BASE-TYPE">/AUTOSAR/BaseTypes/uint16</TYPE-TREF>
    </VARIABLE-DATA-PROTOTYPE>
  </DATA-ELEMENTS>
</SENDER-RECEIVER-INTERFACE>

4.2 ClientServerInterface（客户端-服务器接口）

这个接口是函数调用模式。客户端发起请求，服务器执行并返回结果。有点像你去餐厅点菜——你点单（请求），厨师做菜（执行），服务员端上来（响应）。

什么时候用？

• 需要立即返回结果的操作（计算、查询）
• 需要确认执行成功的操作（写配置、执行动作）
• 操作次数少但每次都很关键

<CLIENT-SERVER-INTERFACE UUID="...">
  <SHORT-NAME>DoorLock_I</SHORT-NAME>
  <IS-SERVICE>false</IS-SERVICE>
  <OPERATIONS>
    <CLIENT-SERVER-OPERATION>
      <SHORT-NAME>LockDoor</SHORT-NAME>
      <ARGUMENTS>
        <ARGUMENT-DATA-PROTOTYPE>
          <SHORT-NAME>DoorId</SHORT-NAME>
          <TYPE-TREF DEST="SW-BASE-TYPE">/AUTOSAR/BaseTypes/uint8</TYPE-TREF>
          <DIRECTION>IN</DIRECTION>
        </ARGUMENT-DATA-PROTOTYPE>
      </ARGUMENTS>
    </CLIENT-SERVER-OPERATION>
  </OPERATIONS>
</CLIENT-SERVER-INTERFACE>

4.3 ModeSwitchInterface（模式切换接口）

这个接口专门用来传递模式信息。比如系统从「正常模式」切换到「省电模式」。它其实是一种特殊的SenderReceiver，但AUTOSAR把它单独拎出来了。

为什么单独存在？

• 模式切换需要广播给所有相关模块
• 模式值有枚举约束（不是任意整数）
• RTE对模式切换有特殊优化

<MODE-SWITCH-INTERFACE UUID="...">
  <SHORT-NAME>SystemMode_I</SHORT-NAME>
  <IS-SERVICE>false</IS-SERVICE>
  <MODE-GROUP>
    <SHORT-NAME>SystemModeGroup</SHORT-NAME>
    <TYPE-TREF DEST="MODE-DECLARATION-GROUP">
      /AUTOSAR/ModeDeclarations/SystemMode
    </TYPE-TREF>
  </MODE-GROUP>
</MODE-SWITCH-INTERFACE>

4.4 ParameterInterface（参数接口）

这个接口比较特殊。它不传递运行时数据，而是传递配置参数。说白了，就是SWC在启动时读取的「固定值」。比如PID控制器的Kp、Ki、Kd系数。

特点：

• 参数在编译时或标定阶段确定
• 运行时一般不修改（除非在线标定）
• 通过SWC内部读取，不需要外部触发

<PARAMETER-INTERFACE UUID="...">
  <SHORT-NAME>PidParams_I</SHORT-NAME>
  <IS-SERVICE>false</IS-SERVICE>
  <PARAMETERS>
    <PARAMETER-DATA-PROTOTYPE>
      <SHORT-NAME>Kp</SHORT-NAME>
      <TYPE-TREF DEST="SW-BASE-TYPE">/AUTOSAR/BaseTypes/float32</TYPE-TREF>
      <INIT-VALUE>1.5</INIT-VALUE>
    </PARAMETER-DATA-PROTOTYPE>
  </PARAMETERS>
</PARAMETER-INTERFACE>

4.5 如何选择？一张图说清楚

你想想看，选接口其实就三个问题：

1. 数据是主动发还是被动取？ 主动发→SenderReceiver；被动取→ClientServer
2. 是模式切换吗？ 是→ModeSwitchInterface
3. 是固定参数吗？ 是→ParameterInterface

4.6 实际项目中的选择策略

我做了这么多年，总结了一个简单粗暴的原则：

场景	推荐接口	原因
传感器数据（车速、温度）	SenderReceiver	多对多通信，解耦好
执行器控制（锁门、开窗）	ClientServer	需要确认执行结果
系统模式切换	ModeSwitch	RTE原生支持模式管理
标定参数（PID系数）	Parameter	编译时确定，运行时只读
故障码上报	SenderReceiver	多个模块需要监听
诊断请求/响应	ClientServer	请求-响应模式天然匹配