Trigger

The `Trigger` category contains a variety of nodes that output values based on a trigger condition, or provide a trigger output.

Change-Of-Value

This node provides a boolean trigger output for a configured duration when the numeric `input` value changes by a configured threshold amount. 

Inputs

1. input - Numeric input value to be monitored for value change.
   
2. [interval] - Numeric setting which configures the amount of time that the boolean `output` will be `true` when a Change-Of-Value event occurs.
   
3. [threshold] - Numeric setting which configures the minimum change amount (of `input`) to trigger a Change-Of-Value event.

Outputs

1. output - Boolean output value.  Will be `true` for the `interval` duration when a Change-Of-Value event occurs.
   

Settings

1. Name - Name of the node.
   
2. Interval - Numeric interval setting (units can be configured).  Fallback from wired `interval` input value.
   
3. Units - Time unit of `Interval` value.
   
4. COV Threshold - Numeric setting for the minimum amount that the `input` must change by to trigger a Change-Of-Value event.  Fallback from wired `threshold` input value.

Operation

When ‘input’ changes value by the `threshold` amount, `output` becomes ‘true’ for ‘interval’ duration, then ‘output’ changes back to ‘false’.  

Random

This node outputs a random number between a configured minimum and a maximum value when triggered.

Inputs

1. trigger - Boolean input value.  `false` to `true` transtion will trigger a new random number at the node `output`.
   
2. [max] - Numeric setting value that configures the maximum value of `output`.
   
3. [min] - Numeric setting value that configures the minimum value of `output`.

Outputs

1. output - Random number between `max` and `max` values.  The `output` value updates on `trigger` input transition from `false` to `true`. 
   

Settings

1. Name - Name of the node.
   
2. Number of Decimal Places - Number of decimal places for random numeric `output` value.
   
3. Maximum Value - Numeric setting value that configures the maximum value of `output`.  Fallback from wired `max` input value.
4. Minimum Value - Numeric setting value that configures the minimum value of `output`.  Fallback from wired `min` input value.

Operation

When ‘trigger’ transitions from ‘false’ to ‘true’, a random number between ‘min’ and ‘max’ values is produced at ‘output’.  The number of decimal places that ‘output’ values have can be set from settings.

Inject

This node sends an input value to `output` when triggered.  Supports all Wires data types.

Inputs

1. [enable] - Boolean input to enable/disable node.
   
2. [message] - Input value to be sent to `output`.  `message` can be any Wires data type. 
   
3. trigger - Boolean input to trigger the sending of `message` to `output`.  When enabled if `trigger` transitions from `false` to `true`, `message` value is passed to `output`.
   

Outputs

1. output - Output value which matches `message` when `enable` is `true` and `trigger` transitions from `false` to `true`.  `output` can be any Wires data type. 

Settings

1. Name - Name of the node.
   
2. Enable - Toggle switch to enable/disable the node.  Fallback from wired input `enable`.
   
3. Message - Configured string value that is sent to `output` when `trigger` transitions from `false` to `true`.  Fallback from wired input `message`.
   

Operation

When ‘enable’ is ‘true’ and `trigger` transitions from `false` to `true`, `message` value is passed to `output`.  `message` and `output` values can be any Wires data types.

Iterator

This node provides a configured number of boolean `false` to `true` output transitions (triggers) over configured time interval.

Inputs

1. [interval] - Numeric interval time setting.  This is the total time to complete the `count` number of `false` to `true` transitions.  Time units configured from settings.
2. [iterations] - Number of `false` to `true` transitions to be generated from `output`.
   
3. start - Boolean input that restarts the interations on `false` to `true` transtion.
   
4. stop - Boolean input that will hold the iterations before the next `false` to `true` transition.  Next iteration will be held while `stop` is `true`, and next iteration will start when `stop` becomes `false`.
   

Outputs

1. output - Boolean output value.  
   
2. complete - Boolean output value, `true` when all iterations have finished.
   
3. count - Numeric value of the current iterations that have completed.
   

Settings

1. Name - Name of the node.
   
2. Interval - Numeric interval time setting.  This is the total time to complete the `count` number of `false` to `true` transitions.   Fallback from wired `interval` input.
3. Units - Time unit of `Interval`.
4. Iterations - Number of `false` to `true` transitions to be generated from `output`.  Fallback from wired `iterations` input.

Operation

This node generates a sequence of `false` to `true` transitions on ‘output’.  The number of `false` to `true` transitions will be equal to ‘count’ value (or `Iterations` setting);  these values are sent over the ‘interval’ duration (unless interrupted by ‘stop’ input).  For example, if ‘interval’ is set to 5 (seconds) and ‘iterations’ is set to 5, a `false` to `true` transition will occur on ‘output’ every 1 second.  If 'stop’ input is ‘true’ then the next ‘true’ value will not be sent from ‘output’ until ‘stop’ is ‘false’ again. ‘interval’ units can be configured from settings. Maximum ‘interval’ setting is 587 hours.   If the ‘Generate False’ setting is not ticked (default), then a ‘false’ message will be sent between each ‘true’ at ‘output’.  

Related Articles:

1. Rubix Wires: Working with Nodes