-
-
Notifications
You must be signed in to change notification settings - Fork 0
Configuration
mchristegh edited this page Jul 15, 2026
·
1 revision
This page owns the edit-dialog reference: every field, its default, and what it does. Concepts get one line here and a link to their owning page.
The dialog adapts to the Type Mode: numeric fields (aggregation, direction, trigger/release values) show in Numeric mode; vote rules and value lists show in Boolean mode. The At least N rules reveal their count field only when selected.
| Field | Default | Notes |
|---|---|---|
| Type Mode | Numeric | Numeric or Boolean — chosen per node, never per message. One node instance = one group of like sensors. See Type Modes. |
| Aggregation | Mean | Numeric mode: Mean, Median, Min, Max, or Trimmed Mean (needs ≥ 3 fresh sources; silently falls back to Mean below that, reported as mean(fallback)). See Type Modes. |
| Trigger When | Aggregate ≥ Trigger Value | Direction: trigger on rising (≥) or falling (≤) aggregate. See Trigger and Release. |
| Trigger Value | (blank) | Numeric mode threshold. Blank means not set — the node accumulates and reports but never triggers. |
| Release Value | (blank) | Numeric mode hysteresis. Blank means same as trigger, and follows a runtime settrigger dynamically. A value on the wrong side of the trigger is sanitized at startup with a single warning. See Trigger and Release. |
| Trigger Rule | Majority | Boolean mode vote: Any, Majority (≥ half), All, or At least N (with its count field). See Trigger and Release. |
| Release Rule | Same as trigger | Boolean mode; a looser rule than the trigger is the boolean form of hysteresis (flap suppression). |
| True Values / False Values |
true, on, yes, 1 / false, off, no, 0
|
Boolean coercion lists, case-insensitive. Custom lists replace the defaults, they don't extend them. See Type Modes. |
| Field | Default | Notes |
|---|---|---|
| Expected Sources | (blank) | Comma-separated topics. Blank = learn sources dynamically on first reading. Listing them makes never-reporting sensors visible from deploy. See Sources Freshness and Quorum. |
| Quorum | 0 | Minimum fresh sources required for trigger/release evaluation. 0 disables quorum. |
| Staleness Window / Units | 0 / Seconds | How long a source's latest value is trusted after its last reading. 0 disables staleness — values are held indefinitely. |
| On Quorum Lost While Latched | Hold | What a triggered node does when quorum disappears: Hold keeps the last consensus; Release fails safe immediately. See Sources Freshness and Quorum. |
| Field | Default | Notes |
|---|---|---|
| Emit aggregate on change only | Checked | Suppresses accepted-reading events on output 4 when the aggregate didn't change. sourceadded, sourcerecovered, and all rejections always emit. See Output Messages. |
| Field | Default | Notes |
|---|---|---|
| Heartbeat Interval / Units | 0 / Seconds | Fixed-cadence status snapshot on output 3. 0 disables. Runs continuously from deploy. See Heartbeat. |
| Field | Default | Notes |
|---|---|---|
| Resume state on deploy/restart | Off | Saves sources, latch, and runtime overrides across deploys/restarts, with wall-clock staleness re-evaluation on restore. See Persistence. Not related to Node-RED's "Persistent Context". |
| Field | Default | Notes |
|---|---|---|
| Name | (blank) | Optional. When blank, the node labels itself from its configuration, e.g. Consensus: mean ≥ 60 or Consensus: at least 2. |
Every configured threshold and the staleness window can also be changed at runtime by message — see Input Messages.
Getting Started
Reference
Features
Examples
- Examples Basic Numeric Averaging
- Examples Staleness and Quorum
- Examples Boolean Voting
- Examples Runtime Commands
Test Script Coverage
- Overview
- Test Suite 1 — Output routing & envelope shape
- Test Suite 2 — Aggregation functions
- Test Suite 3 — Boolean mode
- Test Suite 4 — Commands
- Test Suite 5 — Threshold set-commands & release-follows-trigger
- Test Suite 6 — Status labels
- Test Suite 7 — Staleness, quorum policies, heartbeat
- Test Suite 8 — Persistence
Support