node-red-contrib-power-saver 3.2.3 → 3.4.0

package/docs/examples/example-cascade-temperature-control.md

@@ -0,0 +1,345 @@
+# Cascade temperature control
+
+## Description
+
+The controller changes the setpoint of climate entities to regulate the temperature of room with increased responsiveness, accuracy, and stability.
+
+### An example
+
+A room has a temperature sensor and en electric heater. Given a setpoint temperature, the controller can make the sensor match the given value by adjusting the temperature settings of the electric heater. This type of control usually reacts faster and is more accurate then the alternative of simply changing the temperature settings of the heater. The flow requires that node-red, home assistant, and the connection to the climate entity are stable.
+
+![cascade_flow](../images/node-ps-strategy-heat-capacitor-cascade-control.png)
+
+![cascade_example](https://deltamotion.com/support/webhelp/rmctools/Controller_Features/Control_Modes/Advanced_Control/CascadeLoop.png)
+
+The example utilizes a PID controller to provide a number between 0 and 1 to indicate a load on the heater
+
+A cascade temperature controller is a controller which utilizes the input/setpoints of other controllers/climate entities to regulate to its own setpoint
+
+---
+
+## Requirements
+
+> Home assistant integrated with Node-RED
+
+> The PID node installed - https://flows.nodered.org/node/node-red-contrib-pid
+
+> A climate entity
+
+## Instructions
+
+> Create an `input_number` entity in Home Assistant and name it "cascade_setpoint"
+
+> Create an `input_boolean` entity in Home Assistant and name it `cascade_enabled`
+
+- When set to false, this will disengage the controller
+
+> Import the flow into Node-RED
+
+> Enter the correct sensor tempertaure entity in the `Temp sensor` node
+
+> Change the climate entity name in three places
+
+- Current climate settings - node
+- Set Temperature node - two places
+  - `Entity ID`
+  - `Data`
+
+> (optional) Change the oven setpoint range - see figure below.
+
+- This regulates what values the controller sends to the oven. As a default, the value sent is oven_setpoint = setpoint +- 5 degrees. That is, for a setoint of 10C, the controller will be sending setpoints between 5 and 15 C to the oven. This is further limited to whole numbers, a minimum value of 5, and a maximum value of 30.
+
+> (reccomended) Tune the PID controller - Detailed instructions can be found here: http://blog.clanlaw.org.uk/pid-loop-tuning.html
+
+- Measure the system and find the overshoot time
+  - Set the proportional band to **zero** and place the setpoint a bit above the current measured value (se figure).
+  - Wait for the system to overshoot the target temperature and measure the time it takes for the system to return to the setpoint.
+- Set the proportional band. This is the value indicates how much the measured temperature is allowed to deviate from the setpoint before max load is applied.
+- Spesify the integral time. A good value is two times the overshoot time.
+- Insert the derivative time. A good value here is half of the overshoot time.
+
+![oven_setoint](../images/oven-setpoint-calculation.png)
+![overshoot_time](../images/overshoot-time.png)
+
+---
+
+## Flow
+
+---
+
+::: details Flow code
+
+```json:no-line-numbers
+[
+  {
+    "id": "29fde6c61057362b",
+    "type": "tab",
+    "label": "PID Controller - cascade",
+    "disabled": false,
+    "info": "",
+    "env": []
+  },
+  {
+    "id": "61ae0bee1a382102",
+    "type": "server-state-changed",
+    "z": "29fde6c61057362b",
+    "name": "Setpoint",
+    "server": "e2dd69fb.8f70a8",
+    "version": 3,
+    "exposeToHomeAssistant": false,
+    "haConfig": [
+      { "property": "name", "value": "" },
+      { "property": "icon", "value": "" }
+    ],
+    "entityidfilter": "input_number.cascade_setpoint",
+    "entityidfiltertype": "exact",
+    "outputinitially": true,
+    "state_type": "num",
+    "haltifstate": "",
+    "halt_if_type": "str",
+    "halt_if_compare": "is",
+    "outputs": 1,
+    "output_only_on_state_change": false,
+    "for": 0,
+    "forType": "num",
+    "forUnits": "minutes",
+    "ignorePrevStateNull": false,
+    "ignorePrevStateUnknown": false,
+    "ignorePrevStateUnavailable": false,
+    "ignoreCurrentStateUnknown": true,
+    "ignoreCurrentStateUnavailable": true,
+    "outputProperties": [
+      { "property": "payload", "propertyType": "msg", "value": "", "valueType": "entityState" },
+      { "property": "data", "propertyType": "msg", "value": "", "valueType": "eventData" },
+      { "property": "topic", "propertyType": "msg", "value": "", "valueType": "triggerId" }
+    ],
+    "x": 120,
+    "y": 100,
+    "wires": [["f8958d382348c254"]]
+  },
+  {
+    "id": "ef1c6050d6de41c7",
+    "type": "server-state-changed",
+    "z": "29fde6c61057362b",
+    "name": "Temp. sensor",
+    "server": "e2dd69fb.8f70a8",
+    "version": 3,
+    "exposeToHomeAssistant": false,
+    "haConfig": [
+      { "property": "name", "value": "" },
+      { "property": "icon", "value": "" }
+    ],
+    "entityidfilter": "sensor.kjokken_temp",
+    "entityidfiltertype": "exact",
+    "outputinitially": true,
+    "state_type": "num",
+    "haltifstate": "",
+    "halt_if_type": "str",
+    "halt_if_compare": "is",
+    "outputs": 1,
+    "output_only_on_state_change": false,
+    "for": 0,
+    "forType": "num",
+    "forUnits": "seconds",
+    "ignorePrevStateNull": false,
+    "ignorePrevStateUnknown": false,
+    "ignorePrevStateUnavailable": false,
+    "ignoreCurrentStateUnknown": true,
+    "ignoreCurrentStateUnavailable": true,
+    "outputProperties": [
+      { "property": "payload", "propertyType": "msg", "value": "", "valueType": "entityState" },
+      { "property": "data", "propertyType": "msg", "value": "", "valueType": "eventData" },
+      { "property": "topic", "propertyType": "msg", "value": "", "valueType": "triggerId" }
+    ],
+    "x": 130,
+    "y": 160,
+    "wires": [["ee1904546f36bdcb"]]
+  },
+  {
+    "id": "f8958d382348c254",
+    "type": "function",
+    "z": "29fde6c61057362b",
+    "name": "Specify topic",
+    "func": "msg.topic = \"setpoint\"\nflow.set('setpoint',msg.payload)\nreturn msg",
+    "outputs": 1,
+    "noerr": 0,
+    "initialize": "",
+    "finalize": "",
+    "libs": [],
+    "x": 270,
+    "y": 100,
+    "wires": [["6f77dd60c21180e1"]]
+  },
+  {
+    "id": "6f77dd60c21180e1",
+    "type": "PID",
+    "z": "29fde6c61057362b",
+    "name": "",
+    "setpoint": "7",
+    "pb": "0.6",
+    "ti": "3600",
+    "td": "900",
+    "integral_default": 0.5,
+    "smooth_factor": "2",
+    "max_interval": "600",
+    "enable": 1,
+    "disabled_op": 0,
+    "x": 430,
+    "y": 140,
+    "wires": [["ea6adedb7e2fc14e"]]
+  },
+  {
+    "id": "ea6adedb7e2fc14e",
+    "type": "function",
+    "z": "29fde6c61057362b",
+    "name": "Calc oven setpoint",
+    "func": "msg.load = msg.payload\n//Max adjustment is +-5 degrees\ntemp = flow.get('setpoint')+ 5 * 2 * (msg.load-0.5)\n//Some ovens have max and min temperature settings\nif(temp<5) {temp=5.0;}\nif(temp>30) {temp=30.0;}\n//Many ovens cannot deal with decimals.\ntemp = Math.round(temp)\nmsg.heater_setpoint=temp\nreturn msg",
+    "outputs": 1,
+    "noerr": 0,
+    "initialize": "",
+    "finalize": "",
+    "libs": [],
+    "x": 590,
+    "y": 140,
+    "wires": [["45925567a1177d5b"]]
+  },
+  {
+    "id": "5fa07ec0c1842823",
+    "type": "api-current-state",
+    "z": "29fde6c61057362b",
+    "name": "Current climate settings",
+    "server": "e2dd69fb.8f70a8",
+    "version": 3,
+    "outputs": 1,
+    "halt_if": "",
+    "halt_if_type": "str",
+    "halt_if_compare": "is",
+    "entity_id": "climate.my_climate",
+    "state_type": "str",
+    "blockInputOverrides": false,
+    "outputProperties": [
+      { "property": "payload", "propertyType": "msg", "value": "", "valueType": "entityState" },
+      { "property": "data", "propertyType": "msg", "value": "", "valueType": "entity" }
+    ],
+    "for": 0,
+    "forType": "num",
+    "forUnits": "minutes",
+    "x": 950,
+    "y": 140,
+    "wires": [["ba7e48582e04c14c", "0a7c09c92a01178e"]]
+  },
+  {
+    "id": "ba7e48582e04c14c",
+    "type": "switch",
+    "z": "29fde6c61057362b",
+    "name": "Not same?",
+    "property": "data.attributes.temperature",
+    "propertyType": "msg",
+    "rules": [{ "t": "neq", "v": "heater_setpoint", "vt": "msg" }],
+    "checkall": "true",
+    "repair": false,
+    "outputs": 1,
+    "x": 1150,
+    "y": 140,
+    "wires": [["1114bb7e63d16e98", "0a7c09c92a01178e"]]
+  },
+  {
+    "id": "1114bb7e63d16e98",
+    "type": "api-call-service",
+    "z": "29fde6c61057362b",
+    "name": "Sett temperatur",
+    "server": "e2dd69fb.8f70a8",
+    "version": 3,
+    "debugenabled": false,
+    "service_domain": "climate",
+    "service": "set_temperature",
+    "entityId": "climate.my_climate",
+    "data": "{\"entity_id\":\"climate.my_climate\",\"temperature\":\"{{heater_setpoint}}\"}",
+    "dataType": "json",
+    "mergecontext": "",
+    "mustacheAltTags": false,
+    "outputProperties": [],
+    "queue": "none",
+    "x": 1320,
+    "y": 140,
+    "wires": [[]]
+  },
+  {
+    "id": "45925567a1177d5b",
+    "type": "api-current-state",
+    "z": "29fde6c61057362b",
+    "name": "Enabled?",
+    "server": "e2dd69fb.8f70a8",
+    "version": 3,
+    "outputs": 2,
+    "halt_if": "true",
+    "halt_if_type": "bool",
+    "halt_if_compare": "is",
+    "entity_id": "input_boolean.cascade_enabled",
+    "state_type": "habool",
+    "blockInputOverrides": false,
+    "outputProperties": [
+      { "property": "enabled", "propertyType": "msg", "value": "", "valueType": "entityState" },
+      { "property": "data", "propertyType": "msg", "value": "", "valueType": "entity" }
+    ],
+    "for": 0,
+    "forType": "num",
+    "forUnits": "minutes",
+    "x": 760,
+    "y": 140,
+    "wires": [["5fa07ec0c1842823"], []]
+  },
+  {
+    "id": "0a7c09c92a01178e",
+    "type": "debug",
+    "z": "29fde6c61057362b",
+    "name": "",
+    "active": false,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "statusVal": "",
+    "statusType": "auto",
+    "x": 1330,
+    "y": 240,
+    "wires": []
+  },
+  {
+    "id": "ee1904546f36bdcb",
+    "type": "delay",
+    "z": "29fde6c61057362b",
+    "name": "",
+    "pauseType": "delay",
+    "timeout": "100",
+    "timeoutUnits": "milliseconds",
+    "rate": "1",
+    "nbRateUnits": "1",
+    "rateUnits": "second",
+    "randomFirst": "1",
+    "randomLast": "5",
+    "randomUnits": "seconds",
+    "drop": false,
+    "allowrate": false,
+    "outputs": 1,
+    "x": 290,
+    "y": 160,
+    "wires": [["6f77dd60c21180e1"]]
+  },
+  {
+    "id": "e2dd69fb.8f70a8",
+    "type": "server",
+    "name": "Home Assistant",
+    "version": 2,
+    "addon": true,
+    "rejectUnauthorizedCerts": true,
+    "ha_boolean": "y|yes|true|on|home|open",
+    "connectionDelay": false,
+    "cacheJson": true,
+    "heartbeat": true,
+    "heartbeatInterval": "30"
+  }
+]
+```
+:::

package/docs/examples/example-heat-capacitor.md

@@ -0,0 +1,271 @@
+# Simple heat capacitor strategy flow 
+
+## Description
+
+The heat capacitor strategy utilizes a large body of mass, like your house or cabin, to procure heat at a time where electricity is cheap, and divest at a time where electricity is expensive.
+
+This is achieved by increasing the temperature setpoint of one or several climate entities at times when electricity is cheap, and reducing it when electricity is expensive.
+
+It is a good application for cabins/heated storage spaces, as the entity never actually shuts off the climate entities and should therefore be rather safe to apply (still at you own risk :-)). It can also be used for you house, jacuzzi, and/or pool.
+
+![Temperature profile vs. cost](../images/heat-capacitor-temperatureVsPrice.png)
+
+---
+
+## Requirements
+
+> Home assistant integrated with Node-RED
+
+> Tibber node installed and correctly configured
+
+> A climate entity
+
+## Instructions
+
+> Create an `input_number` entity in Home Assistant named `setpoint`
+
+> Import the flow into Node-RED
+
+> Configure the heat-capacitor node:
+  - Insert an approximate time it takes to increase the temperature by 1 Centigrade (could be 90 minutes)
+  - Insert an approximate time it takes to decrease 1 Centigrade
+  - Insert minimum savings for a heating/cooling cycle (should not be zero, as a cycle might have a cost)
+
+> Configure the climate service to target the correct climate entity (this has to be edited in two places)
+  - Change `Entity Id` in the properties menu
+  - Change the `entity_id` value in the `Data` property
+
+> (optional) If the `input_number` entity was named something else than `setpoint`, change the `entity_id` of the `Setpoint` node accordingly.
+
+### Advanced set-up
+
+> Replace the `Set temperature` node with a [Cascade controller](./example-cascade-temperature-control.md) to improve the heaters accuracy and response time.
+
+---
+
+## Flow
+
+![Simple example with Tibber](../images/node-ps-strategy-heat-capacitor-simple-flow-example.png)
+
+---
+
+
+::: details [Flow code]
+
+```json:no-line-numbers
+[
+    {
+        "id": "135c4e7649611314",
+        "type": "tab",
+        "label": "PowerSaver",
+        "disabled": false,
+        "info": "",
+        "env": []
+    },
+    {
+        "id": "cf5908a52e0aee5e",
+        "type": "ps-receive-price",
+        "z": "135c4e7649611314",
+        "name": "Price Receiver",
+        "x": 400,
+        "y": 320,
+        "wires": [
+            [
+                "b7b85590b7d28ba6"
+            ]
+        ]
+    },
+    {
+        "id": "b08bc12bf8734c5a",
+        "type": "tibber-query",
+        "z": "135c4e7649611314",
+        "name": "",
+        "active": true,
+        "apiEndpointRef": "9ea07b03b88cb526",
+        "x": 230,
+        "y": 320,
+        "wires": [
+            [
+                "cf5908a52e0aee5e"
+            ]
+        ]
+    },
+    {
+        "id": "d0d4dd31efe67e85",
+        "type": "inject",
+        "z": "135c4e7649611314",
+        "name": "",
+        "props": [
+            {
+                "p": "payload"
+            },
+            {
+                "p": "topic",
+                "vt": "str"
+            }
+        ],
+        "repeat": "60",
+        "crontab": "",
+        "once": true,
+        "onceDelay": "1",
+        "topic": "",
+        "payload": "{   viewer {     homes {       currentSubscription {         priceInfo {           today {             total             startsAt           }           tomorrow {             total             startsAt           }         }       }     }   } }",
+        "payloadType": "str",
+        "x": 90,
+        "y": 320,
+        "wires": [
+            [
+                "b08bc12bf8734c5a"
+            ]
+        ]
+    },
+    {
+        "id": "4831f393a0066565",
+        "type": "api-call-service",
+        "z": "135c4e7649611314",
+        "name": "Set temperature",
+        "server": "e2dd69fb.8f70a8",
+        "version": 3,
+        "debugenabled": false,
+        "service_domain": "climate",
+        "service": "set_temperature",
+        "entityId": "climate.my_climate",
+        "data": "{\"entity_id\":\"climate.my_climate\",\"temperature\":\"{{adj_setpoint}}\"}",
+        "dataType": "json",
+        "mergecontext": "",
+        "mustacheAltTags": false,
+        "outputProperties": [],
+        "queue": "none",
+        "x": 980,
+        "y": 320,
+        "wires": [
+            []
+        ]
+    },
+    {
+        "id": "027f4267d969e1b8",
+        "type": "server-state-changed",
+        "z": "135c4e7649611314",
+        "name": "Setpoint",
+        "server": "e2dd69fb.8f70a8",
+        "version": 3,
+        "exposeToHomeAssistant": false,
+        "haConfig": [
+            {
+                "property": "name",
+                "value": ""
+            },
+            {
+                "property": "icon",
+                "value": ""
+            }
+        ],
+        "entityidfilter": "input_number.setpoint",
+        "entityidfiltertype": "exact",
+        "outputinitially": true,
+        "state_type": "num",
+        "haltifstate": "",
+        "halt_if_type": "str",
+        "halt_if_compare": "is",
+        "outputs": 1,
+        "output_only_on_state_change": false,
+        "for": 0,
+        "forType": "num",
+        "forUnits": "minutes",
+        "ignorePrevStateNull": false,
+        "ignorePrevStateUnknown": false,
+        "ignorePrevStateUnavailable": false,
+        "ignoreCurrentStateUnknown": true,
+        "ignoreCurrentStateUnavailable": true,
+        "outputProperties": [
+            {
+                "property": "payload.config.setpoint",
+                "propertyType": "msg",
+                "value": "",
+                "valueType": "entityState"
+            },
+            {
+                "property": "data",
+                "propertyType": "msg",
+                "value": "",
+                "valueType": "eventData"
+            },
+            {
+                "property": "topic",
+                "propertyType": "msg",
+                "value": "",
+                "valueType": "triggerId"
+            }
+        ],
+        "x": 420,
+        "y": 360,
+        "wires": [
+            [
+                "b7b85590b7d28ba6"
+            ]
+        ]
+    },
+    {
+        "id": "b7b85590b7d28ba6",
+        "type": "ps-strategy-heat-capacitor",
+        "z": "135c4e7649611314",
+        "name": "Heat capacitor",
+        "timeHeat1C": "70",
+        "timeCool1C": 50,
+        "maxTempAdjustment": "1",
+        "boostTempHeat": "2",
+        "boostTempCool": "2",
+        "minSavings": 0.08,
+        "setpoint": 23,
+        "x": 600,
+        "y": 320,
+        "wires": [
+            [
+                "2b7cbdef3203a482"
+            ],
+            [],
+            []
+        ]
+    },
+    {
+        "id": "2b7cbdef3203a482",
+        "type": "function",
+        "z": "135c4e7649611314",
+        "name": "Adjust setpoint",
+        "func": "//In case the climate entity can only handle integers\n//Calculate rounded setpoint for the climate entity and return the msg\nmsg.adj_setpoint=Math.round(msg.payload);\nreturn msg\n",
+        "outputs": 1,
+        "noerr": 0,
+        "initialize": "",
+        "finalize": "",
+        "libs": [],
+        "x": 800,
+        "y": 320,
+        "wires": [
+            [
+                "4831f393a0066565"
+            ]
+        ]
+    },
+    {
+        "id": "9ea07b03b88cb526",
+        "type": "tibber-api-endpoint",
+        "feedUrl": "wss://api.tibber.com/v1-beta/gql/subscriptions",
+        "queryUrl": "https://api.tibber.com/v1-beta/gql",
+        "name": "Tibber"
+    },
+    {
+        "id": "e2dd69fb.8f70a8",
+        "type": "server",
+        "name": "Home Assistant",
+        "version": 2,
+        "addon": false,
+        "rejectUnauthorizedCerts": true,
+        "ha_boolean": "y|yes|true|on|home|open",
+        "connectionDelay": false,
+        "cacheJson": true,
+        "heartbeat": false,
+        "heartbeatInterval": 30
+    }
+]
+```
+:::

package/docs/examples/example-nordpool-current-state.md

@@ -154,7 +154,6 @@ In this example, data is read from the Nord Pool sensor in HA via the `current s
         "minSaving": "0.03",
         "sendCurrentValueWhenRescheduling": true,
         "outputIfNoSchedule": "true",
-        "scheduleOnlyFromCurrentTime": "false",
         "x": 630,
         "y": 380,
         "wires": [

package/docs/examples/example-tibber-mqtt.md

@@ -120,7 +120,6 @@ In this example, data is read from Tibber and used to turn on/off a switch, sche
     "minSaving": "0.05",
     "sendCurrentValueWhenRescheduling": true,
     "outputIfNoSchedule": "true",
-    "scheduleOnlyFromCurrentTime": "false",
     "x": 490,
     "y": 160,
     "wires": [["467a5fe.d0bbba", "5e485ff7.db156"], ["9c978d1c.ee76", "467a5fe.d0bbba"], ["42d8b632.402e38"]]

package/docs/faq/README.md

@@ -1,5 +1,28 @@
+---
+sidebar:
+  - /faq/README.md
+  - /faq/best-save-viewer.md
+---
+
 # FAQ
 
+## How can I contribute?
+
+You can donate:
+
+<DonateButtons/>
+
+or take a look at the [contribute page](../contribute/README.md)
+
+## Why is the best save schedule like this?
+
+There may be many reasons for the best save node planning like it does. Here are some considerations:
+
+- It is turning off only if it can save the `Min saving` amount in average per kWh per hour for the hours turned off, compared to the next hour that is on.
+- It will not turn off more than `Max per sequence` hours, so it may have to stay on through the most expensive hours, if there are more than the configured number of hours until the price is low enough.
+
+In order to understand how the node works, try out the [Best Save Viewer](./best-save-viewer.md)
+
 ## Why does the Best Save node not turn off the most expensive hours?
 
 Here is an example:
@@ -12,7 +35,7 @@ Why does it not save the most expensive period?
 
 If you move the saving-period 4-5 hours earlier, the most expensive hours would have been saved. Why is this not better?
 
-Remember that the power that is not used during the saving-period, will be used immediately after. At least, that is the idea, and the normal behaviour if the power consumer is a water heater or another heater controlled by a thermostat. So, then the power would be used one of the blue hours in stead of the green cheaper hour.
+Remember that the power that is not used during the saving-period, will be used immediately after. At least, that is the idea, and the normal behavior if the power consumer is a water heater or another heater controlled by a thermostat. So, then the power would be used one of the blue hours in stead of the green cheaper hour.
 
 Also remember that when saving, you do not save the full price. You only save what is the difference between the price during the saved hours and the price the hour immediately after.
 
@@ -21,3 +44,7 @@ So the best saving is found where this difference is the largest, and that is no
 Of course, if you expand the saving period from 5 to 10 hours you would save even more, but that would be a different case, and you can do that if it is ok for you to turn off for that long time.
 
 Another alternative is to reduce the minimum saving from 0.05 to 0.001. Then the 3 first red hours would be turned off, but the last red would have to be on, in order to get one hour on until the next 5-hour period off. This would however not save you for much money, since the hour that is on is almost as expensive as the hours you would turn off.
+
+## Can we get Legionella bacteria when turning off the water heater?
+
+Many people ask if there is a danger that legionella bacteria will grow and become dangerous when the temperature of the water heater is lowered. As long as the water is heated to at least 65 °C every day, or at least every week, the risk of infection is not considered significant, according to the norwegian [FHI](https://www.fhi.no/nettpub/legionellaveilederen/).