kitControl-SequenceLinear
This component provides sequenced rotating staging control of from two to 10 BooleanWritables based upon the status numeric In value (0-100). An adjustable delay time is also provided.
SequenceLinear is available in the HVAC folder of the kitControl palette. A similar object is the SequenceBinary, which uses a weighted method (vs. a rotating method) for sequencing.
This component supports applications that need to sequence two to 10 loads or stages in a linear or rotating sequence. With linear sequencing, the first stage on will be the last stage off. With rotating sequencing, the first stage on will be the first stage off. The In property, which is a StatusNumeric, controls the number of stages that should be on. The input range is defined by the In Minimum and In Maximum properties.
For example, On and Off setpoints are calculated for each stage by the following formulas (this assumes that five outputs are defined).
| Linear | Rotating | |
|---|---|---|
| range = InMaximum - InMinimum | 100 = 100 - 0 | 100 = 100 - 0 |
| delta = range / NumberOutputs | 20 = 100 / 5 | 20 = 100 / 5 |
| OnSetpointA = 1 * delta | 20 | 20 |
| OnSetpointB = 2 * delta | 40 | 40 |
| OnSetpointC = 3 * delta | 60 | 60 |
| OnSetpointD = 4 * delta | 80 | 80 |
| OnSetpointE = 5 * delta | 100 | 100 |
| OffSetpointA = 0 * delta, 4 * delta | 0 | 80 |
| OffSetpointB = 1 * delta, 3 * delta | 20 | 60 |
| OffSetpointC = 2 * delta, 2 * delta | 40 | 40 |
| OffSetpointD = 3 * delta, 1 * delta | 60 | 20 |
| OffSetpointE = 4 * delta, 0 * delta | 80 | 0 |
| Property | Value | Description |
|---|---|---|
| Facets | Config Facets window | Defines text to display for each Boolean value. trueText configures to describe the state when the component returnstrue. falseText configures to describe the state when the component returnsfalse. This configuration applies to the Out property values. |
| In | number (defaults to 0.00) and null definition | Determines the number of stages that should currently be On. |
| In Minimum | single digit to two decimal places (defaults to 0.00) | Defines the In value that turns all outputs off. |
| In Maximum | three-digit number to two decimal places (defaults to 100) | Defines the In value that turns all outputs on. |
| Number Outputs | number between 2 and 10 inclusive (defaults to 3) | Defines the number of outputs or stages. |
| Out A-J | read-only StatusBoolean values: true or false | Controls each of from two to 10 loads. The Number Outputs property defines how many are available. |
| Delay | hours minutes seconds (defaults to no delay) | Defines the amount of time that must pass between changes in outputs. The default time is 0 seconds. |
| On Delay Active | read-only StatusBoolean values: true or false (default) | Indicates true when the on delay timer is active. |
| Off Delay Active | read-only StatusBoolean values: true or false (default) | Indicates true when the off delay timer is active. |
| Desired Stages On | read-only | Indicates the calculated number of stages that should be on based on the In property. |
| Current Stages On | read-only | Indicates the number of stages that are currently on. Normally Current Stages On and Desired Stages On are the same. They differ when going through a transition with the delay timer active. |
| Next Stage On | read-only | Indicates the next stage to be turned on if needed. |
| Next Stage Off | read-only | Indicates the next stage to be turned off if needed. |
| Action | drop-down list | Selects between Linear and Rotating action. Linear configures Out A (Stage 1) to always be the first stage to turn on and the last stage to turn off. Rotating configures the first stage to turn on and increment to the next stage each time Current Stages On goes to 0. |
| Rotate Time | hours minutes seconds (defaults to one second) | Specifies the amount of time that the outputs remain in a fixed configuration before the component shifts them to the next configuration. |
| Rotate Timer Active | read-only status Boolean values: true or false (default) | Indicates that the rotate timer is active. |