Bus Selector
Select elements from incoming bus
- Library:
Simulink / Commonly Used Blocks
Simulink / Signal Routing
HDL Coder / Signal Routing
Description
The Bus Selector block outputs the elements you select from the input bus. The block can output the selected elements separately or in a new virtual bus.
Ports
Input
Output
Parameters
Elements in the bus — List of elements in input bus
list of element names
List of elements in the input bus from which to select output elements.
If you change an element name while the Block Parameters dialog box is open, you can see the updated name by clicking Refresh.
To highlight the source of an element entering the block, select the element in the list and click Find.
Programmatic Use
Block Parameter:
InputSignals |
| Type: cell array |
| Values: element names |
Filter by name — Search term for filtering displayed input elements
text
Search term for filtering displayed input elements, specified as text. Do not enclose the search term in quotation marks. The filter does a partial string search.
To access the filtering options, click the Show filtering
options
button to the right of the Filter by
name box.
Enable regular expression — Option to filter displayed input elements by regular expression
off (default) | on
Option to filter the displayed input elements by regular expression.
When this parameter is enabled, entering t$ in the
Filter by name box displays all elements whose
names end with a lowercase t (and their immediate
parents). For details, see Regular Expressions.
Dependencies
To access this parameter, click the Show filtering
options
button on the right side of the Filter by
name box.
Show filtered results as a flat list — Option to display filtered results as a flat list
off (default) | on
Option to display filtered results as a flat list that uses dot notation to reflect the hierarchy of buses. By default, the filtered elements appear in a hierarchical tree.
Dependencies
To access this parameter, click the Show filtering
options
button on the right side of the Filter by
name box.
Selected elements — Selected elements of input bus
list of elements names
The selected elements of the input bus.
To specify an output element, select an element from the Elements in the bus list, and then click the Select button. The element is added at the end of the Selected elements list. To add elements below an existing element, select an element in the Selected elements list before you click Select. Elements are added below the element you selected.
If you select multiple elements from the Elements in the bus list, the order in which you select them is the order in which Simulink® inserts them in the Selected elements list.
If an output element listed in the Selected elements
list is not an input to the Bus Selector block, the element
name starts with three question marks (???).
To change the order of the output bus elements, use the Up and Down buttons. Port connectivity with downstream blocks is maintained when you change the element order.
To remove bus elements from the block output, use the Remove button. You can select multiple contiguous elements to move or remove.
Tip
In the Simulink Editor, as you draw a new line close to the output side of a Bus Selector block when all output ports are already connected, Simulink:
Adds a port
Prompts you to specify the element to be selected
You cannot use this automatic port addition approach if:
A bus input is not connected to the Bus Selector block.
You do not specify an element in response to the prompt that appears when you draw a line close to the Bus Selector block icon.
You select the Output as virtual bus parameter.
Programmatic Use
Block Parameter:
OutputSignals |
| Type: character vector |
Values: character vector in the
form of 'signal1,signal2' |
| Default: none |
Output as virtual bus — Option to output selected elements as virtual bus
off (default) | on
Option to output the selected elements as a virtual bus.
By default, the block outputs each of the selected elements from a separate output port that is labeled with the corresponding bus element name. When this parameter is enabled, the block outputs the selected elements from one port, grouped in a virtual bus.
The output bus is virtual. To convert the output to a nonvirtual bus,
insert a Signal Conversion block
after the Bus Selector block. Set the Signal
Conversion block Output parameter to
Nonvirtual bus and set the Data
type to a Simulink.Bus object.
When the Selected elements list includes only one element and you enable Output as virtual bus, then that element is not wrapped in a bus. For example, if the element is a bus, the output element is that bus. If the element is not a bus, the output element is not a bus.
Programmatic Use
Block Parameter:
OutputAsBus |
| Type: character vector |
Values:
'on' | 'off' |
Default:
'off' |
Block Characteristics
Data Types |
|
Direct Feedthrough |
|
Multidimensional Signals |
|
Variable-Size Signals |
|
Zero-Crossing Detection |
|
Tips
For buses at subsystem and model interfaces, you can use In Bus Element blocks instead of an Inport block with a Bus Selector block. In Bus Element blocks:
Reduce line complexity and clutter in a block diagram.
Make it easier to change the interface incrementally.
Allow access to a bus element closer to the point of usage, avoiding the use of a Bus Selector and Goto block configuration.
Extended Capabilities
See Also
Bus Assignment | Bus Creator | Bus to Vector | Out Bus Element