Demultiplexer vTool#
The Demultiplexer vTool accepts data at its Data input pin and outputs the data collected via the DataN output pins. You can specify as many output pins as required. The data type of the Data input pin is generic. The output pins adopt the data type of the input provided.
Using the Index input pin, you can route incoming data items to output pins other than the default. You can use the Mini Script vTool to provide index information.
Download the pylon Software Suite to use the Demultiplexer vTool.
仕組み#
The Demultiplexer accepts input of any data type from a single vTool at its Data input pin. You can specify how many discrete data items (updates) you want to collect and whether you want to output each data item individually via several output pins or all of them in one array via a single output pin. The vTool stores incoming values in slots: one slot per data item. In Blockwise operating mode, data stays in memory until all slots have been filled. Then, everything is output together. In Continuous operating mode, each new data item can trigger an output that includes all filled slots up to and including the current one. For more details, see Operating Mode in Configuration Settings below.
Routing Incoming Data to Output Pins#
An internal index is used to route data items to output pins via the corresponding slots. By default, incoming data items are routed to output pins according to this index. The first item to arrive is sent to the first slot and on to the first output pin. This internal counter starts at 0 and is reset to 0 every time a recipe is started.
If you connect the Index input pin of the Demultiplexer, you can override the internal index and shift incoming data items to the desired output pins.
Another way to override the internal index is using the Offset option. The offset value specified is added to the internal counter, producing a shift in the incoming data.
Example: You have 3 slots configured and specify an offset of 1. This would send the data item that would have gone to slot/output pin 1 to slot/output pin 2. Data item 2 would go to slot/output pin 3. Data item 3 wraps around and would go to slot/output pin 1.
This wrapping behavior also occurs if the offset value is higher than the number of slots configured.
Configuration Settings#
- Operating Mode: This determines the manner in which incoming data items are output.
- Blockwise: Incoming data items are collected and output together at the same time. The individual items are held in slots until the specified number of data items has been collected. Use the Number Of Slots parameter to specify how many data items you want to collect.
- Continuous: Each incoming data item triggers the output of data from all filled slots, including the current one. This means that when the first data item arrives and fills the first slot, it is output immediately. When the second data item arrives, the first item and the second item are output together, and so on. Use the Number Of Slots parameter to specify how many data items you want to collect. After all slots have been filled at least once, each further incoming data item still triggers an output that includes all slot values; routing to slots continues to follow the internal index, Index input, or Offset parameter value.
- Output Mode: This determines whether incoming data items are output individually or as an array.
- Individual: Incoming data items are output individually. There is a dedicated output pin for each incoming data item. The Number Of Slots parameter value determines the number of output pins.
- Array: Incoming data items are output as an array. There is one output pin holding all data items. If the data type of the Data input pin is an array, this mode is not available.
- Number Of Slots: Use this parameter to specify the number of slots, i.e., the desired number of data items you want to collect and output. In Individual output mode, this is also the number of output pins created. In Array output mode, this is the number of items in the array.
- Offset: By specifying an offset, you can shift incoming data items to the desired slot and corresponding output pin. By default, incoming data items are routed to output pins according to the internal index. If the Offset parameter is set to 0, incoming data item 1 is sent to slot/output pin 1, data item 2 is sent to slot/output pin 2, and so on. For more details, see Routing Incoming Data to Output Pins.
- Index input pin: Connect this input pin, e.g., to the Mini Script vTool, to override the internal counter and route incoming data items to the desired output pins. If this pin isn't connected or no input is received, the internal counter is used. If the Index pin has an error and input is received at the Data input pin in the same update, that input is discarded. For more details, see Routing Incoming Data to Output Pins.
vToolの設定#
To configure the Demultiplexer vTool, double-click it in the Workbench. A dialog opens showing all the available settings. Alternatively, you can find the same settings in the Features - All pane.
入力#
Data#
Accepts input of any data type.
- Data type: Initially Value. Once a connection is made, it takes the data type of the output pin connected.
Index#
- Data type: Accepts integer input for overriding the internal counter.
出力#
DataN#
Returns the input held in the corresponding slot.
- Data type: Initially Value. Once a connection is made, it takes the data type of the Data input pin.
Array#
Returns the data items received in one array.
- Data type: Initially Value. Once a connection is made, it is an array type whose elements match the data type of the Data input pin.
関連するvTools#
典型的な先行機#
- カメラvTool
- Image Loading vTool
- Mini Script vTool (for the Index input)
典型的な後継機#
- Any vTool that accepts the data type supplied on the Data input pin (connect to each DataN output or the Array output as required by your recipe).