Skip to content

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.

Type and thresholds

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.

Sources and trust

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.

Output behavior

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.

Heartbeat

Field Default Notes
Heartbeat Interval / Units 0 / Seconds Fixed-cadence status snapshot on output 3. 0 disables. Runs continuously from deploy. See Heartbeat.

Persistence

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".

Name

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.

Clone this wiki locally