Polybench® Reference
Selects one channel from the input bus to connect to the output. The channel is selected by the functions Next and Previous, or by the variable parameter Current Channel.

Multiplexer

Overview

This operator selects one channel from all the channels in the bus that is connected to the input. The channel selection can be controled from the measurement configuration itself, by using either the variable parameter CurrentChannel or the functions of this operator. The channels are selected on number.

This operator can be used for all sample types.

Operator ports

Input Any: Any sample type. The connection is not limited to one type of signal.

Output Any_n: Any sample type. The connection is not limited to one type of signal.

Properties

Find more information about changing properties here: link

DefaultChannel
type: Undefined
The channel that is selected at start up or after reset (1...N where N is the number of input channels).


ConstantOutputID
type: True or False
Set to false, if the output channel ID should always be equal to the currently selected channel. The channel ID determines the graphical appearance of the signal in viewers.
Select one of those presets:
True or False
True may also be read like 'yes' and false like 'no'

By default the output channel ID will a constant value, independent of the selected input channel. In viewers, the color and ranges etc. will stay the same for each selected channel.
If the output ID is copied from the currently selected input channel, then in viewers the appearance of any signals may change according to the selected channel.

Caption
type: Word or phrase
The name of the object in the project. This name must not contain '.' or '$' characters.

Every object has the Caption property. This property is very important, because it is the name by which Polybench recognizes this object.
It is allowed to give multiple objects the same name, as long as the objects are of the same type. In that case, a reference to this caption includes all the objects with the same caption.
In Polybench, every object can be addressed by an Address specifier, which starts with the dollar sign, for example: $My Page.My Object. 'My Page' would be the Caption of a page, and 'My Object' the Caption of an object on that page.

Documentation
type: See description
Optional documentation of this object.

It is good practice to write in short notes why you have used this object, and why its properties are set the way they are set. If this object is an operator, the Documentation text is displayed below the operator symbol.

Variable Parameters

Find more information about Variable Parameters here: link

CurrentChannel
type: See description
The channel that is currently selected (1...N where N is the number of input channels)

Functions

Find more information about Functions here: link

Previous
Select the previous channel from the input. If the current channel is the first channel, then nothing will happen.

Next
Select the next channel from the input. If the current channel is the last channel, then nothing will happen.

Details

When a new channel is selected by the Multiplexer, then the output channel changes its name and unit according to the selected input. Whether the output ID changes with the input, depends on the

WARNING: In Polybench versions prior to 1.30, the Multiplexer only worked for floating point signals.

Examples

Example: Multiplexer to select constants Demo
Demonstrates that the Multiplexer can be used to select out of a set of input constant values, and write the constant value in a variable (using a Constant To Action operator). It is also shown that if the Next and Previous functions are called from an Action Button, that the button is disabled if no next or previous channels exist.
Examples\DF0409038_001_Multiplexer_to_Select_Constants_Demo.xmc