⟹

Input Port

Subsystems
运行在线示例 免费 · 无需注册 · 直接在浏览器中运行

InPort(输入端口)模块用于为 Subsystem(子系统)容器建立外部输入接口。它接收到达子系统边界外部的输入信号,并将其透明穿透传递给子系统内部的下游算法模块。

在子系统内部放置一个 InPort 模块,会自动在其父级 Subsystem 模块外层边界上生成一个对应的物理输入引脚,从而支持模块化、多层级的复杂动态系统拓扑构建与清晰封装。

数学模型

InPort 模块在数学上表现为理想透明的跨层级边界信号穿透传递:

yinternal(t)={uexternal(t),若外部子系统输入引脚已连接vdefault,其他y_{\text{internal}}(t) = \begin{cases} u_{\text{external}}(t), & \text{若外部子系统输入引脚已连接} \\ v_{\text{default}}, & \text{其他} \end{cases}

其中:

  • uexternal(t)u_{\text{external}}(t) 为连接至父级 Subsystem 外部输入引脚上的连续或离散信号。
  • vdefaultv_{\text{default}} 为配置的 defaultValue 缺省回退值。
  • 信号穿透层级边界的过程是瞬时发生的,无任何数值相位滞后:
Δtboundary=0\Delta t_{\text{boundary}} = 0

输入与输出

Direction ID Label 类型 Status
← Out out Internal Output number Output

参数

参数 Label 类型 默认值 描述
portName Port Name text input1
defaultValue Default Value number 0

使用示例

示例 1: 闭环速度控制器子系统边界输入端口定义

构建包含误差计算与 PID 校正的模块化速度控制子系统。在子系统内部添加分别命名为 "setpoint" 和 "feedback" 的两个 InPort 模块,即会在顶层父模块外壳上自动暴露两个清晰的输入引脚,支持整洁连接参考设定值信号与转速计测量信号。

示例 2: 三轴机器人运动学解算多输入端口阵列

将三自由度机器人机械臂逆运动学算法封装至子系统内部。使用三个分别命名为 "x_ref"、"y_ref" 与 "z_ref" 且配置 defaultValue = 0.0 的 InPort 模块,在子系统边界上清晰暴露笛卡尔空间参考坐标输入。

说明与最佳实践

  • 外壳引脚动态自适应生成: 在子系统内每添加或删除一个 InPort 模块,父级 Subsystem 外观图块上都会动态创建或移除对应的连线端子。
  • 零传播延迟: 信号在同一解算步长内即时由外层穿越至内层,不存在任何计算延迟或多余的数据缓存复制。
  • 安全缺省回退: 当外部未连接信号线时,defaultValue 可确保内部模块获得受控的确定性初始值,杜绝空指针或 NaN 异常。
  • 子系统布局规范: 建议将 InPort 模块整齐排列在子系统画布的左侧区域,以契合自左向右(西到东)的标准信号流向。

相关模块

  • OutPort: 子系统层级边界输出端口模块。
  • Subsystem: 树状分层模型容器模块。
  • From: 无线虚拟信号接收器。
  • ExternalInput: 通过脚本 API 或用户交互界面注入外部控制量的信号源。