4. 连接器与接口设计
在 Modelica 中，组件之间的交互不是通过函数调用，而是通过连接器（connector）建立物理意义上的“共点”关系。连接器定义了一个物理域中组件对外暴露的接口，它决定了哪些量可以跨组件传递、以什么方向传递、以及连接后方程如何生成。理解连接器，本质上就是理解 Modelica 如何把“物理连接”翻译成“数学约束”。
一、物理域与连接器的定义
一个物理域通常由一对互补的变量类型刻画：势变量（potential variable）与流变量（flow variable）。势变量描述“共点”处的状态，例如电气域中的电压 v、机械平移域中的位移 s、热域中的温度 T、流体域中的压力 p。流变量描述通过该点的“通量”，例如电流 i、力 f、热流量 Q_flow、质量流量 m_flow。
在 Modelica 中，流变量用前缀 flow 声明，其余变量默认为势变量。例如电气接口的标准写法是：
connector Pin
Modelica.Units.SI.Voltage v "Potential at the pin";
flow Modelica.Units.SI.Current i "Current flowing into the pin";
end Pin;这里 v 是势变量，i 是流变量。连接两个 Pin 时，Modelica 自动生成两类方程：所有被连接连接器的势变量相等（p1.v = p2.v = …），所有流变量之和为零（p1.i + p2.i + … = 0）。这正是基尔霍夫电压定律与电流定律在连接器层面的体现。
二、势变量与流变量的语义约定
流变量的正方向约定非常关键。Modelica 规定：流变量正值表示“流入连接器所代表的组件”。因此，在 Pin 中 i 的正方向是流入该引脚所连组件。若某电阻两端引脚都按此约定，则流入电阻的电流之和为零，与节点电流守恒一致。若把正方向理解反了，模型仍可能“跑通”，但能量符号、功率计算和结果解释都会出错。
势变量则没有方向性，它只表示连接点处的公共值。连接后所有势变量被强制相等，因此势变量不能在同一连接点被重复“赋值”，否则会过约束。例如两个理想电压源直接并联，会因势变量相等而冲突，需要加入小内阻或使用更合适的建模方式。
flow 还是普通变量，可以问：这个量是“共点处的状态”还是“穿过该点的通量”？状态用势变量，通量用流变量。若两者都像，通常说明该物理域需要更细致的接口拆分。三、连接器兼容性与多域接口适配
连接器兼容性由变量名、类型、单位、维数和 flow 前缀共同决定。两个连接器只有在这些方面一致时才能直接连接。常见的不兼容包括：单位不同（V 与 kV）、维数不同（标量与数组）、流变量前缀不一致、变量名不同。Modelica 工具通常会在连接时给出类型检查错误，而不是静默转换。
多域系统需要把不同物理域的接口组合起来。例如机电作动器同时包含电气 Pin、机械 Flange 和信号 RealInput。此时有两种做法：一是使用 expandable connector 定义总线式接口，把多个域的信号聚合到一个可扩展连接器中；二是为每个域保留独立连接器，通过适配组件（如 IdealGear、TorqueToCurrent 等）完成域间转换。前者适合信号密集的系统，后者适合物理量明确、需要严格单位检查的场合。
四、接口复用策略
接口复用的核心是“一次定义、多处使用”。最直接的方式是继承标准库连接器，例如 extends Modelica.Electrical.Analog.Interfaces.Pin，这样既保证单位与语义一致，又能被标准组件直接连接。若需要增加额外变量，可在继承后追加，但要注意新增变量默认是势变量，若它本质是通量，必须显式加 flow。
第二种策略是参数化接口。例如定义一个 connector FluidPort，其中包含 Medium 替换参数，使同一连接器可适配不同工质。这样接口结构不变，但介质属性随参数变化，适合多工质系统复用。
第三种策略是使用 expandable connector 构建总线。它允许在连接时动态添加信号，适合控制信号密集、域间耦合复杂的系统。但代价是类型检查变弱，容易因拼写错误引入隐式新信号。因此建议在总线中只放信号类变量，物理量仍用强类型连接器。
五、一个可执行的接口设计检查清单
设计新连接器时，可按以下顺序逐项确认，避免后期返工：
| 检查项 | 判断依据 | 常见错误 |
|---|---|---|
| 物理域归属 | 该接口属于电气、机械、热、流体还是信号域 | 把信号域与物理域混在一个连接器 |
| 势变量选择 | 连接点处被强制相等的状态量 | 把通量误设为势变量 |
| 流变量选择 | 穿过连接点的通量，需加 flow | 漏写 flow 导致守恒方程缺失 |
| 正方向约定 | 流变量正值流入组件 | 正方向反了，功率符号错误 |
| 单位与维数 | 与标准库或目标组件一致 | V 与 kV 混用、标量与数组混用 |
| 可连接性 | 变量名、类型、前缀完全匹配 | 变量名不同导致无法连接 |
| 复用方式 | 继承、参数化或 expandable | 重复定义导致维护困难 |
以电气域为例，若把 Pin 中的 i 漏写 flow，连接两个引脚后只会生成 v₁ = v₂，而不会生成 i₁ + i₂ = 0，节点电流守恒丢失，电路方程数不足，仿真会报“方程数与变量数不匹配”。这是连接器设计中最典型、也最容易排查的错误之一。
总结来看，连接器设计不是“声明几个变量”那么简单，它同时承担了物理语义、数学约束和复用契约三重角色。势变量与流变量的选择决定了方程结构，正方向约定决定了符号一致性，兼容性检查决定了能否直接连接，而多域适配与复用策略决定了库的可扩展性。把这四点在设计初期想清楚，后续组件开发和系统集成会顺畅得多。