Products & Services Solutions Academia Support User Community Company

Learn more about Simulink   

Bus Creator - Create signal bus

Library

Signal Routing

Description

The Bus Creator block combines a set of signals into a bus. To bundle a group of signals with a Bus Creator block, set the block's Number of inputs parameter to the number of signals in the group. The block displays the number of ports that you specify. Connect the signals to be grouped to the resulting input ports. See Using Composite Signals for information about buses.

The signals in the bus will be ordered from the top input port to the bottom input port. See How to Rotate a Block in the Simulink documentation for a description of the port order for various block orientations.

You can connect any type of signal to the inputs, including other bus signals. To ungroup the signals, connect the block's output port to a Bus Selector port.

Naming Signals

The Bus Creator block assigns a name to each signal on the bus that it creates. This allows you to refer to signals by name when searching for their sources (see Browsing Bus Signals) or selecting signals for connection to other blocks. The block offers two bus signal naming options. You can specify that each signal on the bus inherits the name of the signal connected to the bus (the default) or that each input signal must have a specific name.

To specify that bus signals inherit their names from input ports, select Inherit bus signal names from input ports from the list box on the block's parameter dialog box. The names of the inherited bus signals appear in the Signals in bus list box.

The Bus Creator block generates names for bus signals whose corresponding inputs do not have names. The names are of the form signaln, where n is the number of the port to which the input signal is connected.

You can change the name of any signal by editing its name on the block diagram or in the Signal Properties dialog box. If you change a name in this way while the Bus Creator block's dialog box is open, you must close and reopen the dialog box or click the Refresh button next to the Signals in bus list to update the name in the dialog box.

To specify that the bus inputs must have specific names, select Require input signal names to match signals below from the list box in the block's parameter dialog box. The block's parameter dialog box displays the names of the signals currently connected to its inputs, or a generated name (for example, signal2) for an anonymous input. You can now use the parameter dialog box to change the required names of the block's inputs.

To change the required signal name, select the signal in the Signals in bus list. The selected signal's name appears in the Rename selected signal field. Edit the name in the field and click Apply or OK.

Browsing Bus Signals

The Signals in bus list on a Bus Creator block's parameter dialog box displays a list of the signals entering the block. A plus sign (+) next to a signal indicates that the signal is itself a bus. You can display its contents by clicking the plus sign. If the expanded input includes bus signals, plus signs appear next to the names of those bus signals. You can expand them as well. In this way, you can view all signals entering the block, including those entering via buses. To find the source of any signal entering the block, select the signal in the Signals in bus list and click the adjacent Find button. Simulink software opens the subsystem containing the signal source, if necessary, and highlights the source's icon.

Data Type Support

The Bus Creator block accepts and outputs real or complex values of any data type supported by Simulink software, including fixed-point and enumerated data types.

For a discussion on the data types supported by Simulink software, refer to Data Types Supported by Simulink.

Parameters and Dialog Box

Signal naming options

Assign input signal names to the corresponding bus signals.

Settings

Default: Inherit bus signal names from input ports

Inherit bus signal names from input ports

Assign input signal names to the corresponding bus signals.

Require input signal names to match signals below

Inputs must have the names listed in the Signals in bus list.

Dependencies

Selecting Require input signal names to match signals below enables Rename selected signal.

Command-Line Information

See Block-Specific Parameters for the command-line information.

Number of inputs

Specify the number of input ports on this block.

Settings

Default: 2

To bundle a group of signals, enter the number of signals in the group.

Command-Line Information

See Block-Specific Parameters for the command-line information.

Signals in bus

Show the signals in the output bus.

Settings

When you modify the Number of inputs parameter, click Refresh to update the list of signals.

Tips

Command-Line Information

See Block-Specific Parameters for the command-line information.

Rename selected signal

List the name of the signal currently selected in the Signals in bus list when you select the Require input signal names to match signals below option.

Settings

Default: ''

Edit this field to change the name of the currently selected signal.

Dependencies

Selecting Require input signal names to match signals below for Parameters and signal1 or signal2 for Signals in bus enables this parameter.

Command-Line Information

See Block-Specific Parameters for the command-line information.

Specify properties via bus object

Use a bus object to define the structure of the bus created by this block.

Settings

Default: Off

On

Use a bus object to define the structure of the bus created by this block.

Off

Do not use a bus object to define the structure of the bus created by this block.

Tips

Selecting this parameter is required when creating a nonvirtual bus, and optional when creating a virtual bus.

Command-Line Information

See Block-Specific Parameters for the command-line information.

Bus object

Specify the name of the bus object used to define the structure of the bus created by this block.

Settings

Default: BusObject

The default value is a dummy bus object name. Type in the name of the bus object you want to use. If you need to create or change a bus object, click Edit to the left of the Bus object field to open the Simulink Bus Editor. See Using the Bus Editor for more information.

Tips

At the beginning of a simulation or when you update the model's diagram, Simulink software checks whether the signals connected to this Bus Creator block have the specified structure. If not, Simulink software displays an error message.

Dependencies

Specify properties via bus object enables this parameter.

Command-Line Information

See Block-Specific Parameters for the command-line information.

Output as nonvirtual bus

Output a nonvirtual bus.

Settings

Default: Off

On

Output a nonvirtual bus.

Off

Output a virtual bus.

Tips

Dependencies

Specify properties via bus object enables this parameter.

Command-Line Information

See Block-Specific Parameters for the command-line information.

Characteristics

Multidimensionalized

Yes

Virtual

Yes, if the output bus is virtual

For more information, see Virtual Blocks in the Simulink documentation.

See Also

  


Related Products & Applications

Learn more about Simulink through this collection of videos, articles, technical literature and the Getting Started with Simulink Guide.

 © 1984-2009- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS