Engee documentation

Bus Creator

Forms a virtual bus from signals of different types.

bus creator

Description

The Bus Creator unit combines a set of input elements into a bus. Any type of elements, including other buses, can be connected to the input ports. The bus elements can be accessed using the Bus Selector block.

The output port of the Bus Creator block can only be connected to the input port of the Bus Selector block.

Bus elements must have unique names. By default, each bus element inherits the name of the element connected to the Bus Creator block. If duplicate names are present, the Bus Creator block adds the port number to all input element names. For elements that have no names, the Bus Creator block generates names of the form signaln, where n is the port number connected to the element. You can refer to items by name when searching for their sources or selecting items to connect to other blocks.

Ports

Input

Port_1 - input element to be included in the bus
bus

Input ports of the block accept elements for inclusion in the bus. The number of input ports is determined by the Number of inputs parameter.

Data types: Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64, Bool.

Output

Port_1 - output virtual bus
bus

The output bus consists of input elements.

Data types: Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64, Bool.

Parameters

Number of inputs - list of elements in the input bus
2 (by default) | ` integer`

The number of input elements must be an integer greater than or equal to 2. Increasing the number of input parameters adds empty input ports to the block. Before you simulate the model, make sure that an input element is connected to each input port.

If you change the Number of inputs parameter, click the Update button to update the list of items.

If all input ports are already connected, you can add an input port to the Bus Creator block by connecting another line to it. Adding a port interactively updates the Number of inputs parameter and adds the new item to the list of items on the bus.

Usage in program code

Block parameter

Inputs

Values

an integer greater than or equal to 2, comma-separated list of item names.

By default, the Inputs parameter specifies the number of inputs. When you use it to specify element names on the bus, the number of inputs corresponds to the number of element names you specify.

Elements in the bus - list of input elements
`Elements list

The list of input elements includes all elements included in the block, including elements of nested buses. An arrow next to an element indicates that the input element is a bus. Click the arrow to display the contents of that bus.

To select the source of an element included in the block, select the element in the list and click the Find button.

If you change the name of an item while the parameter window is open, click Update to update the name in the list.

To rearrange the items in the output bus, use the Up and Down buttons. You can select multiple neighbouring top-level elements in the Elements in the bus list to rearrange or delete them.

To add or remove input elements, press the Add or Delete button respectively. Before assembling the model, make sure that an input element is connected to each input port.

Usage in program code

Block parameter

Inputs

Values

an integer greater than or equal to 2, comma-separated list of item names.

By default, the Inputs parameter specifies the number of inputs. When you use it to specify element names on the bus, the number of inputs corresponds to the number of element names you specify.

Output data type - output bus data type
Inherit: auto (by default) | Bus: <object name> | <data type expression>

Specify the type of output data.

Usage in program code

Block parameter

OutDataTypeStr

Value

Inherit: auto | Bus: <object name>

By default

Inherit: auto

Additional options

C code generation: Yes