虚拟引脚
虚拟引脚是最为特殊的参数类别,它虽然在参数列表中进行定义,但在设计逻辑上更贴近于引脚的概念。
定义虚拟引脚
虚拟引脚类型的参数可配置项如下表所示。
配置项 | 含义 | 说明 |
---|---|---|
键 | 参数的唯一标识符 | 填写英文、数字及下划线 _ 组成的字符串,不可以数字开头。参数的键为参数的唯一标识,不可重复。 |
名称 | 参数的显示名称 | 填写字符串,可以填写中文,可以重复。 |
详细描述 | 鼠标在参数上悬浮时,悬浮框显示的补充说明 | 填写字符串,可以填写中文,可以用 Markdown 输入,可以重复。 |
条件 | 参数的可用性条件 | 填写逻辑表达式,默认为 true,可以直接引用其它参数。以调用键为 par 的参数为例,可以支持 (par-1)>1 , sqrt(par) 等表达式形式。与参数引用的“表达式”模式的区别在于,此处在参数定义时不需要使用 $ 标识符。 |
类型 | 参数的类型选择 | 此处选择 虚拟引脚 选项。 |
输入类型 | 可在变量 和常量 间选择其一 | 目前 CloudPSS 仅支持常量类型,此处请选择常量。虚拟引脚类型的参数可以视为引脚,其本身就具有传入可变参数的功能。 |
默认值 | 参数的虚拟引脚默认值,即在新调用本模块或在本模块中新建参数方案时的默认值 | 如果连接类型是输入引脚,则需要以 @ 符号开头,如果是输出引脚,则需要以 # 符号开头。 |
数据 X 维数 | 虚拟引脚数据的行数 | 填写整数,用来定义虚拟引脚的纵向维数。以三相元件为例时,此处填写 3。 |
数据 Y 维数 | 虚拟引脚数据的列数 | 填写整数,用来定义虚拟引脚的横向维数,一般情况下(包括三相元件在内)均为 1。 |
数据类型 | 虚拟引脚的数据类型选择 | 可在实数、 整数、 文本、 布尔之间选择其一,一般情况下选择实数即可。 |
连接类型 | 虚拟引脚的电气/控制类型选择 | 可在输入、输出之间选择其一。目前 SimStudio 的虚拟引脚仅支持控制引脚类型,不支持电气类型的引脚。 |
与引脚的定义不同,用户需在接口标签页的参数列表中完成对虚拟引脚的定义,定义虚拟引脚与定义参数类似。
绑定虚拟引脚
完成虚拟引脚的定义之后,用户可以在模型库的模块-基础栏中找到模块虚拟端口元件,如下图所示。
将它添加至图纸后,可以绑定该虚拟引脚,如下图所示。
引用虚拟引脚
在绑定好虚拟引脚后,可在拓扑实现标签页中引用该虚拟引脚。
引用虚拟引脚与引用引脚类似,这里不过多阐述。
后续更新
目前,SimStudio 仅支持在拓扑实现中完成虚拟引脚的引用。暂不支持在代码实现的元件中引用虚拟引脚,请期待后续更新。
案例
在**同步发电机(model/CloudPSS/SyncGeneratorRouter)**元件中,其 电压源-电机切换信号(键为 s2m
)和 定子端电压有效值量测信号(键为 VT_o
)的参数类型即为虚拟引脚。
其中,s2m
用来触发电机的电压源-电机转换动作,该虚拟引脚参数的连接类型为输入,其参数配置如下:
VT_o
参数用来监测电机的端口电压有效值,该虚拟引脚参数的连接类型为输出,其参数配置如下: