跳到主要内容

虚拟引脚

虚拟引脚是最为特殊的参数类别,它虽然在参数列表中进行定义,但在设计逻辑上更贴近于引脚的概念。

定义虚拟引脚

虚拟引脚类型的参数可配置项如下表所示。

配置项含义说明
参数的唯一标识符填写英文、数字及下划线 _ 组成的字符串,不可以数字开头。参数的键为参数的唯一标识,不可重复
名称参数的显示名称填写字符串,可以填写中文,可以重复。
详细描述鼠标在参数上悬浮时,悬浮框显示的补充说明填写字符串,可以填写中文,可以用 Markdown 输入,可以重复。
条件参数的可用性条件填写逻辑表达式,默认为 true,可以直接引用其它参数。以调用par 的参数为例,可以支持 (par-1)>1 , sqrt(par) 等表达式形式。与参数引用“表达式”模式的区别在于,此处在参数定义时不需要使用 $ 标识符。
类型参数的类型选择此处选择 虚拟引脚 选项。
输入类型可在变量常量间选择其一目前 CloudPSS 仅支持常量类型,此处请选择常量。虚拟引脚类型的参数可以视为引脚,其本身就具有传入可变参数的功能。
默认值参数的虚拟引脚默认值,即在新调用本模块或在本模块中新建参数方案时的默认值如果连接类型输入引脚,则需要以 @ 符号开头,如果是输出引脚,则需要以 # 符号开头。
数据 X 维数虚拟引脚数据的行数填写整数,用来定义虚拟引脚的纵向维数。以三相元件为例时,此处填写 3。
数据 Y 维数虚拟引脚数据的列数填写整数,用来定义虚拟引脚的横向维数,一般情况下(包括三相元件在内)均为 1。
数据类型虚拟引脚的数据类型选择可在实数、 整数、 文本、 布尔之间选择其一,一般情况下选择实数即可。
连接类型虚拟引脚的电气/控制类型选择可在输入输出之间选择其一。目前 SimStudio 的虚拟引脚仅支持控制引脚类型,不支持电气类型的引脚。

与引脚的定义不同,用户需在接口标签页参数列表中完成对虚拟引脚的定义,定义虚拟引脚定义参数类似。

虚拟引脚的定义
虚拟引脚的定义

绑定虚拟引脚

完成虚拟引脚的定义之后,用户可以在模型库的模块-基础栏中找到模块虚拟端口元件,如下图所示。

模块虚拟端口
模块虚拟端口

将它添加至图纸后,可以绑定该虚拟引脚,如下图所示。

绑定虚拟引脚
绑定虚拟引脚

引用虚拟引脚

在绑定好虚拟引脚后,可在拓扑实现标签页中引用该虚拟引脚。

引用虚拟引脚与引用引脚类似,这里不过多阐述。

后续更新

目前,SimStudio 仅支持在拓扑实现中完成虚拟引脚的引用。暂不支持在代码实现的元件中引用虚拟引脚,请期待后续更新。

案例

在**同步发电机(model/CloudPSS/SyncGeneratorRouter)**元件中,其 电压源-电机切换信号(键为 s2m)和 定子端电压有效值量测信号(键为 VT_o)的参数类型即为虚拟引脚。

其中,s2m 用来触发电机的电压源-电机转换动作,该虚拟引脚参数的连接类型为输入,其参数配置如下:

s2m参数配置
s2m参数配置

VT_o 参数用来监测电机的端口电压有效值,该虚拟引脚参数的连接类型为输出,其参数配置如下:

VT_o参数配置
VT_o参数配置