node-red-contrib-heat-curve 1.0.0

Node-RED heating curve node - calculates flow temperature setpoint based on outdoor temperature

npm install node-red-contrib-heat-curve

node-red-contrib-heat-curve

Node-RED Heating Curve Node - calculates flow temperature setpoint based on outdoor temperature (Heizkurve).

Features

• Configurable heating curve with slope or design mode
• Night setback (Nachtabsenkung)
• Summer lockout (Sommerabschaltung)
• Two outputs: Flow temp + Heating active boolean
• Min/max flow temperature limits
• Runtime overrides via message properties

Formula

flowTemp = roomTemp + slope × (roomTemp - outdoorTemp) + shift

With setback: flowTemp = flowTemp - setbackDelta

Outputs

• Output 1: Flow temperature setpoint (°C) or null if summer lockout
• Output 2: Heating active boolean (true = heating, false = summer lockout)

Example

slope=1.0, roomTemp=20, shift=0:

Outdoor -10°C → Flow 50°C
Outdoor   0°C → Flow 40°C
Outdoor  10°C → Flow 30°C

With setback (delta=10K):
Outdoor -10°C → Flow 40°C (50-10)

Summer lockout (threshold=18°C):
Outdoor 20°C → Output 1: null, Output 2: false

Configuration

Input

• msg.payload - Outdoor temperature in °C
• msg.setback - true to activate night setback

Runtime Override

All configuration values can be overridden via msg properties. Setback state is retained until explicitly changed.

Output

Output 1:

{
  "payload": 50.0,
  "heatCurve": {
    "outdoorTemp": -10,
    "flowTemp": 50.0,
    "slope": 1.0,
    "roomTemp": 20,
    "shift": 0,
    "minFlow": 20,
    "maxFlow": 75,
    "clamped": false,
    "clampedAt": null,
    "setback": false,
    "setbackDelta": 10,
    "flowTempBeforeSetback": 50.0,
    "summerLockout": 18,
    "heatingActive": true
  }
}

Output 2:

{
  "payload": true
}

Node Status

• -10°C → 50.0°C - Normal heating
• -10°C → 40.0°C (setback) - Night setback active
• 20°C → locked out - Summer lockout
• -20°C → 75.0°C (clamped max) - Clamped to limit

Use Cases

Author

sr.rpo

License

MIT