In Bus Element, Bus Element In

Select signal that connects to input port

• Library:

• Simulink / Ports & Subsystems

  Simulink / Sources

  HDL Coder / Ports & Subsystems

  HDL Coder / Sources

Description

The In Bus Element block, also known as the Bus Element In block, combines the functionality of an Inport block and a Bus Selector block. This block is of the Inport block type and all In Bus Element blocks that use the same port share a Block Parameters dialog box.

You can use an In Bus Element block to select these signals associated with the port:

• For a port that receives a bus, you can select a bus element by specifying a signal name or signal hierarchy in the block label.

• For a port that receives a bus, you can select the entire bus by deleting the signal name in the block label. The block label displays only the port name.

• For a port that receives a nonbus signal, you can select the nonbus signal by deleting the signal name in the block label. The block label displays only the port name.

To select multiple signals from a bus, create multiple In Bus Element blocks. You can create In Bus Element blocks for each selected signal in the Block Parameters dialog box by clicking the Add blocks for selected signals button.

You can load simulation input data for a group of root-level In Bus Element blocks using a structure of timeseries, timetable, or SimulationDatastore objects. In Bus Element blocks interpolate loaded data for all data types except string, enumerated, and fixed point.

Specify a Signal

To change the signal associated with a bus element port block, you must edit the label next to the block by double-clicking the text. Dot notation indicates signal hierarchy within the bus. To reduce the size of the label, you can display only the signal name by selecting Compact Notation from the ellipsis menu that appears when you select the block. To show the signal hierarchy again, you can select Expanded Notation from the menu.

Ports

Output

Port_1 — Selected input signal

signal

Selected input bus or bus element that is associated with an external subsystem or model port.

Data Types: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | Boolean | fixed point | enumerated | bus

Parameters

Port name — Name of input port

InBus (default) | port name

Specify a port name that is not already in use by another block or port. The name appears on the parent Subsystem or Model block. The name also appears next to the block. Multiple blocks can access the same port.

Programmatic Use

Block Parameter: PortName

Type: character vector

Values: 'InBus' | '<port name>'

Default: 'InBus'

Port number — Position of port on parent block

1 (default) | real integer

Specify the order in which the port that corresponds to the block appears on the parent Subsystem or Model block.

• If you add a block that creates another port, the port number is the next available number.

• Deleting all blocks associated with a port deletes the port. Other ports are renumbered so that they are sequential and do not skip any numbers.

• Specifying a port number that exceeds the number of ports creates a port for that number and for any skipped sequential numbers.

Programmatic Use

Block Parameter: Port

Type: character vector

Values: real integer

Default: '1'

Set color — Specify block background color

Black (default) | White | Red | Green | Blue | ...

Specify the background color for bus element port blocks. This specification sets the color of blocks associated with selected bus elements, or of all blocks associated with the port if you do not select any bus elements.

You can specify Black, White, Red, Green, Blue, Cyan, Magenta, Yellow, Gray, Light Blue, Orange, Dark Green, and More Colors.

Programmatic Use

Block Parameter: BackgroundColor

Type: character vector

Values: 'black' | 'white | 'red' | 'green' | 'blue' | 'cyan' | 'magenta' | 'yellow' | 'gray' | 'lightBlue' | 'orange' | 'darkGreen' | '[r,g,b]' where r, g, and b, are the red, green, blue values of the color in the range 0.0 to 1.0

Default: 'black'

Filter — Filter set of displayed signals

text

Specify a search term to use for filtering a long list of bus elements. Do not enclose the search term in quotation marks. The filter does a partial string search and supports regular expressions. To use a regular expression character as a literal, include an escape character (\). For example, to use a question mark, type sig\?1.

Signal Attributes

To specify signal attributes, click the pencil button or the specified attributes next to a signal name.

Data Type — Data type

Inherit: auto (default) | double | single | int8 | uint8 | int16 | uint16 | int32 | uint32 | int64 | uint64 | fixdt(1,16) | fixdt(1,16,0) | fixdt(1,16,2^0,0) | Enum: <class name> | Bus: <object name> | <data type expression>

Specify the data type. The type can be inherited, specified directly, or expressed as a data type object such as Simulink.NumericType. Do not specify a bus object as the expression.

Dimensions — Signal dimensions

-1 (default) | integer | [integer, integer]

Specify the dimensions of a signal.

-1	The signal can have any dimensions.
N	The signal must be a vector of size N.
[R C]	The signal must be a matrix having R rows and C columns.

Programmatic Use

Block Parameter: PortDimensions

Type: character vector

Values: '-1' | integer | [integer, integer]

Default: '-1'

Dims Mode — Allow variable-size signals

Inherit (default) | Fixed | Variable

Specify the type of signals allowed. To allow variable-size and fixed-size signals, select Inherit. To allow only variable-size signals, select Variable. To not allow variable-size signals, select Fixed.

Dependencies

When the signal is variable-sized, the Dimensions parameter specifies the maximum dimensions of the signal.

Command-Line Information

Parameter: VarSizeSig

Type: character vector

Value: 'Inherit '| 'No' | 'Yes'

Default: 'Inherit'

Unit — Physical unit of the signal

inherit (default) | <Enter unit>

Specify the physical unit of the signal. For a list of supported units, see Allowed Unit Systems.

Programmatic Use

Block Parameter: Unit

Type: character vector

Values: 'inherit' | '<Enter unit>'

Default: 'inherit'

Sample time — Specify sample time

-1 (default) | scalar

Specify the discrete interval between sample time hits or specify another appropriate sample time such as continuous or inherited.

By default, the signal inherits its sample time. To set a different sample time, enter a valid sample time based on the table in Types of Sample Time.

Programmatic Use

Block Parameter: SampleTime

Type: character vector

Values: scalar

Default: '-1'

Complexity — Signal type

auto (default) | real | complex

Specify the numeric type of the signal. To choose the numeric type of the signal, select auto. Otherwise, choose a real or complex signal type.

Programmatic Use

Block Parameter: SignalType

Type: character vector

Values: 'auto' | 'real' | 'complex'

Default: 'auto'

Minimum — Minimum value

[] (default) | scalar

Lower value of the range that Simulink^® checks.

This number must be a finite real double scalar value.

Simulink software uses this value to perform:

• Simulation range checking (see Signal Ranges).

• Automatic scaling of fixed-point data types.

• Optimization of the code that you generate from the model. This optimization can remove algorithmic code and affect the results of some simulation modes such as SIL or external mode. For more information, see Optimize using the specified minimum and maximum values (Simulink Coder).

Programmatic Use

Block Parameter: OutMin

Type: character vector

Values: '[ ]'| scalar

Default: '[ ]'

Maximum — Maximum value

[] (default) | scalar

Upper value of the range that Simulink checks.

This number must be a finite real double scalar value.

Simulink software uses this value to perform:

• Simulation range checking (see Signal Ranges).

• Automatic scaling of fixed-point data types.

• Optimization of the code that you generate from the model. This optimization can remove algorithmic code and affect the results of some simulation modes such as SIL or external mode. For more information, see Optimize using the specified minimum and maximum values (Simulink Coder).

Programmatic Use

Block Parameter: OutMax

Type: character vector

Values: '[ ]'| scalar

Default: '[ ]'

Model Examples

Create Bus Ports in a Subsystem

Adding In Bus Element and Out Bus Element blocks to create bus element ports in a subsystem for selecting signals from an input bus and creating an output bus signal.

Open Model

Load Input Data for a Bus Using In Bus Element Blocks

Load input data for a bus using In Bus Element blocks.

Open Live Script

Simulink Bus Signals

Introduces you to the following Simulink® bus signal capabilities: Bus Creator, Bus Selector, and Bus Assignment blocks

Open Model

Block Characteristics

Data Types	Boolean | bus | double | enumerated | fixed point | integer | single | string
Direct Feedthrough	no
Multidimensional Signals	yes
Variable-Size Signals	yes
Zero-Crossing Detection	no

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.

HDL Code Generation

Generate Verilog and VHDL code for FPGA and ASIC designs using HDL Coder™.

This block can be used to simplify the Subsystem bus interfaces when you use the block in subsystems that generate HDL code, but is not included in the hardware implementation.

To learn more about using buses for HDL code generation, see Buses (HDL Coder) and Use Bus Signals to Improve Readability of Model and Generate HDL Code (HDL Coder).

Fixed-Point Conversion
Design and simulate fixed-point systems using Fixed-Point Designer™.