Main Content

本页的翻译已过时。点击此处可查看最新英文版本。

Bus Creator

根据输入元素创建总线

  • 库:
  • Simulink / Commonly Used Blocks

    Simulink / Signal Routing

    HDL Coder / Signal Routing

  • Bus Creator block

说明

Bus Creator 模块可将一组输入元素合并成一条总线。您可以将任何元素类型连接到输入端口,包括其他总线。您可以使用 Bus Selector 模块访问总线中的元素。

总线元素必须具有唯一名称。默认情况下,总线的每个元素都继承连接到 Bus Creator 模块的元素的名称。如果存在重复名称,Bus Creator 模块会将端口号追加到所有输入元素名称。对于没有名称的元素,Bus Creator 模块会生成 signaln 形式的名称,其中 n 是连接到元素的端口号。当您搜索元素源或选择元素以连接到其他模块时,您可以按名称引用元素。有关元素命名规范,请参阅信号名称和标签

端口

输入

全部展开

要包含在总线中的输入元素,指定为标量、向量、矩阵、N 维数组或总线。

输入端口的数量由 Number of inputs 参数决定。

数据类型: single | double | half | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | string | Boolean | fixed point | enumerated | bus
复数支持:

输出

全部展开

由合并的输入元素组成的输出总线,指定为虚拟或非虚拟总线。有关总线类型的详细信息,请参阅合成信号的类型

数据类型: bus

参数

全部展开

输入元素的数量,不少于两个,指定为整数。增加输入的数目会向模块添加空的输入端口。在对模型进行仿真之前,请确保为每个输入端口连接了输入元素。

在修改 Number of inputs 参数后,点击 Refresh 以更新元素列表。

提示

如果所有输入端口都已连接,您可以通过将另一条线连接到 Bus Creator 模块来添加一个输入端口。

A line is dragged near a Bus Creator block with two connected ports and a third port appears.

以交互方式添加端口会更新 Number of inputs 参数,并将新元素添加到总线中的元素列表。

编程用法

模块参数:Inputs
类型:字符向量
值:大于或等于 2 的整数,以逗号分隔的元素名称列表
默认值:'2'

默认情况下,Inputs 参数指定输入的数目。当您使用它来指定总线中元素的名称时,输入的数目与您指定的元素名称的数目相匹配。

要合并到总线中的输入元素的列表。您可以查看进入模块的所有元素,包括嵌套总线中包含的元素。元素旁边的箭头表示输入元素是总线。要显示该总线的内容,请点击箭头。

要重新排列输出总线中的元素,请使用 UpDown 按钮。您可以在 Elements in the bus 列表中选择多个要进行重新排序或删除的顶层相邻元素。

要查找进入模块的任何元素的信源,请在 Elements in the bus 列表中选择元素,然后点击 Find 按钮。Simulink® 会突出显示元素源的图标,必要时会打开包含该元素源的子系统。

如果您在 Block Parameters 对话框打开时更改元素名称,可以通过点击 Refresh 查看更新后的名称。

编程用法

模块参数:Inputs
类型:字符向量
值:大于或等于 2 的整数,以逗号分隔的元素名称列表
默认值:'2'

默认情况下,Inputs 参数指定输入的数目。当您使用它来指定总线中元素的名称时,输入的数目与您指定的元素名称的数目相匹配。

用于筛选显示的输入元素的搜索词,指定为文本。请勿将搜索词括在引号内。筛选器执行部分字符串搜索。

要访问筛选选项,请点击 Filter by name 框右侧的 Show filtering options 按钮。

通过正则表达式筛选显示的输入元素的选项。

在启用此参数的状态下,在 Filter by name 框中输入 t$ 将显示名称以小写 t 结尾的所有元素(及其直接父级)。有关详细信息,请参阅正则表达式

依存关系

要访问此参数,请点击 Filter by name 框右侧的 Show filtering options 按钮。

将筛选结果显示为平面列表的选项,该列表使用圆点表示法来反映总线的层次结构。默认情况下,筛选后的元素显示在层次结构树中。

依存关系

要访问此参数,请点击 Filter by name 框右侧的 Show filtering options 按钮。

输出总线信号的数据类型。

如果选择 “Bus: <object name>”,请用 Simulink.Bus 对象的名称替换 <object name>。编辑模型时,必须可以访问 Bus 对象。

要使用总线编辑器定义 Bus 对象,请点击 Show data type assistant 按钮 ,然后点击 Edit 按钮。

如果选择 “<data type expression>”,请指定一个计算结果为 Bus 对象的表达式。

编程用法

模块参数:OutDataTypeStr
类型:字符向量
'Inherit: auto' | 'Bus: <object name>'
默认值:'Inherit: auto'

检查输入元素名称是否与 Block Parameters 对话框中列出的名称相匹配。如果元素名称不匹配,Simulink 将返回错误。

提示

Require names of inputs to match names above 参数可能会在以后的版本中删除。要强制实施强数据类型,请考虑使用 Use names from inputs instead of from bus object 参数。

依存关系

如果选择 Use names from inputs instead of from bus object,则 Simulink 软件会忽略 Require names of inputs to match names above 设置。

如果以编程方式更改 Number of inputs,则此参数将还原为 'off'

所选输入元素的新名称。有关名称规范,请参阅信号名称和标签

依存关系

要显示此参数,请启用 Require names of inputs to match names above 参数。

默认情况下,Bus Creator 模块使用输入元素名称作为输出总线元素名称,即使您将 Simulink.Bus 对象指定为数据类型也是如此。

要从 Bus 对象继承总线元素名称,请清除此参数。清除此参数将:

  • 强制应用强数据类型。

  • 避免在 Bus 对象和模型中多次输入一个元素名称。多次输入名称可能会无意间创建不匹配的元素名称。

  • 支持在数组元素之间必须具有一致的元素名称这一总线数组要求。

您也可以通过检查输入元素名称是否与 Bus 对象元素名称匹配来强制实施强数据类型。保持选中 Use names from inputs instead of from bus object 复选框,并将 Element name mismatch 配置参数设置为 “error”。

依存关系

要显示此参数,请将 Output data type 参数设置为 Bus 对象。

编程用法

模块参数:InheritFromInputs
类型:字符向量
值: 'on' | 'off'
默认值:'on'

输出非虚拟总线而不是虚拟总线。

非虚拟总线中的所有元素都必须具有相同的采样时间,即使关联的 Bus 对象的元素为某些元素指定了继承采样时间也是如此。任何导致包含不同采样率元素的非虚拟总线的操作都会生成错误。要更改采样时间不同于其他非虚拟总线输入元素的元素或总线的采样时间,请使用 Rate Transition 模块。有关详细信息,请参阅Modify Sample Times for Nonvirtual Buses

要生成使用 C 结构体定义此模块创建的总线结构的代码,请启用此参数。

依存关系

要显示此参数,请将 Output data type 参数设置为 Bus 对象。

编程用法

模块参数:NonVirtualBus
类型:字符向量
值: 'on' | 'off'
默认值:'off'

模块特性

数据类型

Boolean | bus | double | enumerated | fixed point | half | integer | single | string

直接馈通

多维信号

可变大小信号

过零检测

提示

对于位于子系统和模型接口上的总线,您可以使用 Out Bus Element 模块,而不是 Bus Creator 模块和 Outport 模块。Out Bus Element 模块能够:

  • 减少模块图中线的复杂度和杂乱无章。

  • 使增量更改接口更容易。

扩展功能

PLC 代码生成
使用 Simulink® PLC Coder™ 生成结构化文本代码。

在 R2006a 之前推出