@thingwala/node-red-contrib-geyserwala-connect 0.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Thingwala
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/Makefile

@@ -0,0 +1,20 @@
+setup:
+	node -v
+	npm -v
+	mkdir -p .node-red && \
+	cd .node-red && \
+	npm init -y && \
+	npm install node-red && \
+	npm install mqtt && \
+	cd  node_modules && \
+	ln -sf ../.. node-red-contrib-geyserwala-connect
+
+dev:
+	cd .node-red && \
+	npx node-red
+
+login:
+	npm login
+
+publish:
+	npm publish

package/README.md

@@ -0,0 +1,25 @@
+Geyserwala Connect - Node-RED Integration <!-- omit in toc -->
+===
+
+***Automate your Geyserwala Connect from Node-RED***
+
+## Installation
+
+Install `node-red-contrib-geyserwala-connect` using [npm](https://www.npmjs.com/):
+
+```bash
+npm install --save node-red-contrib-geyserwala-connect
+```
+
+## Usage
+
+Use these nodes to integrate with your Geyserwala Connect to automate your Geyserwise system from Node-RED.
+
+
+# Contribution
+
+Yes please! We want our Geyserwala integration with Node-RED to be the best it can be for everyone. If you have Node-RED development experience or have just noticed a niggly bug, feel free to fork this repo and submit a pull request. Here are the [Node-RED docs](https://nodered.org/docs/).
+
+# License
+
+In the spirit of the Hackers of the [Tech Model Railroad Club](https://en.wikipedia.org/wiki/Tech_Model_Railroad_Club) from the [Massachusetts Institute of Technology](https://en.wikipedia.org/wiki/Massachusetts_Institute_of_Technology), who gave us all so very much to play with. The license is [MIT](./LICENSE).

package/examples/Basic_All_Nodes.json

@@ -0,0 +1,606 @@
+[
+    {
+        "id": "fc2acf2da9d1682c",
+        "type": "tab",
+        "label": "Geyserwala Connect",
+        "disabled": false,
+        "info": "",
+        "env": []
+    },
+    {
+        "id": "85b616590e17a12c",
+        "type": "geyserwala-connect-tank-temp",
+        "z": "fc2acf2da9d1682c",
+        "name": "Tank Temp",
+        "geyserwalaApi": "db6794008ea04dea",
+        "x": 380,
+        "y": 60,
+        "wires": [
+            [
+                "691616a2e1b3365d"
+            ]
+        ]
+    },
+    {
+        "id": "c5e8c4ce98d9e562",
+        "type": "geyserwala-connect-element-demand",
+        "z": "fc2acf2da9d1682c",
+        "name": "Element Demand",
+        "geyserwalaApi": "db6794008ea04dea",
+        "x": 360,
+        "y": 100,
+        "wires": [
+            [
+                "691616a2e1b3365d"
+            ]
+        ]
+    },
+    {
+        "id": "5b6755e03df7cf61",
+        "type": "geyserwala-connect-collector-temp",
+        "z": "fc2acf2da9d1682c",
+        "name": "Collector Temp",
+        "geyserwalaApi": "db6794008ea04dea",
+        "x": 360,
+        "y": 140,
+        "wires": [
+            [
+                "691616a2e1b3365d"
+            ]
+        ]
+    },
+    {
+        "id": "dee0237bdf6d3fe6",
+        "type": "geyserwala-connect-pump-status",
+        "z": "fc2acf2da9d1682c",
+        "name": "Pump Status",
+        "geyserwalaApi": "db6794008ea04dea",
+        "x": 370,
+        "y": 180,
+        "wires": [
+            [
+                "691616a2e1b3365d"
+            ]
+        ]
+    },
+    {
+        "id": "691616a2e1b3365d",
+        "type": "debug",
+        "z": "fc2acf2da9d1682c",
+        "name": "info",
+        "active": true,
+        "tosidebar": true,
+        "console": false,
+        "tostatus": false,
+        "complete": "payload",
+        "targetType": "msg",
+        "statusVal": "",
+        "statusType": "auto",
+        "x": 590,
+        "y": 120,
+        "wires": []
+    },
+    {
+        "id": "b159a980e9ca5816",
+        "type": "geyserwala-connect-external-demand",
+        "z": "fc2acf2da9d1682c",
+        "name": "External Demand",
+        "geyserwalaApi": "db6794008ea04dea",
+        "x": 350,
+        "y": 340,
+        "wires": [
+            [
+                "cf52f2f9a6713b72"
+            ]
+        ]
+    },
+    {
+        "id": "4d7df3d6c919b539",
+        "type": "geyserwala-connect-external-setpoint",
+        "z": "fc2acf2da9d1682c",
+        "name": "External Setpoint",
+        "geyserwalaApi": "db6794008ea04dea",
+        "x": 350,
+        "y": 400,
+        "wires": [
+            [
+                "cf52f2f9a6713b72"
+            ]
+        ]
+    },
+    {
+        "id": "b3c9c5848fbafd71",
+        "type": "geyserwala-connect-mode",
+        "z": "fc2acf2da9d1682c",
+        "name": "Mode",
+        "geyserwalaApi": "db6794008ea04dea",
+        "x": 390,
+        "y": 580,
+        "wires": [
+            [
+                "1d89d48c14b6c3b8"
+            ]
+        ]
+    },
+    {
+        "id": "ca4f27161c7f81fa",
+        "type": "geyserwala-connect-setpoint",
+        "z": "fc2acf2da9d1682c",
+        "name": "Setpoint",
+        "geyserwalaApi": "db6794008ea04dea",
+        "x": 380,
+        "y": 640,
+        "wires": [
+            [
+                "1d89d48c14b6c3b8"
+            ]
+        ]
+    },
+    {
+        "id": "94191a9675df61af",
+        "type": "geyserwala-connect-boost-demand",
+        "z": "fc2acf2da9d1682c",
+        "name": "Boost Demand",
+        "geyserwalaApi": "db6794008ea04dea",
+        "x": 360,
+        "y": 700,
+        "wires": [
+            [
+                "1d89d48c14b6c3b8"
+            ]
+        ]
+    },
+    {
+        "id": "fcdc172bc333981b",
+        "type": "inject",
+        "z": "fc2acf2da9d1682c",
+        "name": "",
+        "props": [
+            {
+                "p": "payload"
+            },
+            {
+                "p": "topic",
+                "vt": "str"
+            }
+        ],
+        "repeat": "",
+        "crontab": "",
+        "once": false,
+        "onceDelay": 0.1,
+        "topic": "",
+        "payload": "true",
+        "payloadType": "bool",
+        "x": 110,
+        "y": 220,
+        "wires": [
+            [
+                "fba9a6ea6ed3f0cb"
+            ]
+        ]
+    },
+    {
+        "id": "7555b33894ed93a8",
+        "type": "inject",
+        "z": "fc2acf2da9d1682c",
+        "name": "",
+        "props": [
+            {
+                "p": "payload"
+            },
+            {
+                "p": "topic",
+                "vt": "str"
+            }
+        ],
+        "repeat": "",
+        "crontab": "",
+        "once": false,
+        "onceDelay": 0.1,
+        "topic": "",
+        "payload": "false",
+        "payloadType": "bool",
+        "x": 110,
+        "y": 260,
+        "wires": [
+            [
+                "fba9a6ea6ed3f0cb"
+            ]
+        ]
+    },
+    {
+        "id": "d25e9b6a0b51b3ff",
+        "type": "inject",
+        "z": "fc2acf2da9d1682c",
+        "name": "",
+        "props": [
+            {
+                "p": "payload"
+            },
+            {
+                "p": "topic",
+                "vt": "str"
+            }
+        ],
+        "repeat": "",
+        "crontab": "",
+        "once": false,
+        "onceDelay": 0.1,
+        "topic": "",
+        "payload": "true",
+        "payloadType": "bool",
+        "x": 110,
+        "y": 320,
+        "wires": [
+            [
+                "b159a980e9ca5816"
+            ]
+        ]
+    },
+    {
+        "id": "1cec7d550f31e5e1",
+        "type": "inject",
+        "z": "fc2acf2da9d1682c",
+        "name": "",
+        "props": [
+            {
+                "p": "payload"
+            },
+            {
+                "p": "topic",
+                "vt": "str"
+            }
+        ],
+        "repeat": "",
+        "crontab": "",
+        "once": false,
+        "onceDelay": 0.1,
+        "topic": "",
+        "payload": "false",
+        "payloadType": "bool",
+        "x": 110,
+        "y": 360,
+        "wires": [
+            [
+                "b159a980e9ca5816"
+            ]
+        ]
+    },
+    {
+        "id": "e20fe185478f4007",
+        "type": "inject",
+        "z": "fc2acf2da9d1682c",
+        "name": "",
+        "props": [
+            {
+                "p": "payload"
+            },
+            {
+                "p": "topic",
+                "vt": "str"
+            }
+        ],
+        "repeat": "",
+        "crontab": "",
+        "once": false,
+        "onceDelay": 0.1,
+        "topic": "",
+        "payload": "35",
+        "payloadType": "num",
+        "x": 110,
+        "y": 420,
+        "wires": [
+            [
+                "4d7df3d6c919b539"
+            ]
+        ]
+    },
+    {
+        "id": "9b096ff0a428f394",
+        "type": "inject",
+        "z": "fc2acf2da9d1682c",
+        "name": "",
+        "props": [
+            {
+                "p": "payload"
+            },
+            {
+                "p": "topic",
+                "vt": "str"
+            }
+        ],
+        "repeat": "",
+        "crontab": "",
+        "once": false,
+        "onceDelay": 0.1,
+        "topic": "",
+        "payload": "60",
+        "payloadType": "num",
+        "x": 110,
+        "y": 460,
+        "wires": [
+            [
+                "4d7df3d6c919b539"
+            ]
+        ]
+    },
+    {
+        "id": "b084411925aad05a",
+        "type": "inject",
+        "z": "fc2acf2da9d1682c",
+        "name": "",
+        "props": [
+            {
+                "p": "payload"
+            },
+            {
+                "p": "topic",
+                "vt": "str"
+            }
+        ],
+        "repeat": "",
+        "crontab": "",
+        "once": false,
+        "onceDelay": 0.1,
+        "topic": "",
+        "payload": "SOLAR",
+        "payloadType": "str",
+        "x": 110,
+        "y": 520,
+        "wires": [
+            [
+                "b3c9c5848fbafd71"
+            ]
+        ]
+    },
+    {
+        "id": "f9c9c0f43fd44dae",
+        "type": "inject",
+        "z": "fc2acf2da9d1682c",
+        "name": "",
+        "props": [
+            {
+                "p": "payload"
+            },
+            {
+                "p": "topic",
+                "vt": "str"
+            }
+        ],
+        "repeat": "",
+        "crontab": "",
+        "once": false,
+        "onceDelay": 0.1,
+        "topic": "",
+        "payload": "TIMER",
+        "payloadType": "str",
+        "x": 110,
+        "y": 560,
+        "wires": [
+            [
+                "b3c9c5848fbafd71"
+            ]
+        ]
+    },
+    {
+        "id": "cf52f2f9a6713b72",
+        "type": "debug",
+        "z": "fc2acf2da9d1682c",
+        "name": "automation",
+        "active": true,
+        "tosidebar": true,
+        "console": false,
+        "tostatus": false,
+        "complete": "payload",
+        "targetType": "msg",
+        "statusVal": "",
+        "statusType": "auto",
+        "x": 610,
+        "y": 280,
+        "wires": []
+    },
+    {
+        "id": "1d89d48c14b6c3b8",
+        "type": "debug",
+        "z": "fc2acf2da9d1682c",
+        "name": "manual",
+        "active": true,
+        "tosidebar": true,
+        "console": false,
+        "tostatus": false,
+        "complete": "payload",
+        "targetType": "msg",
+        "statusVal": "",
+        "statusType": "auto",
+        "x": 600,
+        "y": 640,
+        "wires": []
+    },
+    {
+        "id": "c19e8851fc0cbf79",
+        "type": "inject",
+        "z": "fc2acf2da9d1682c",
+        "name": "",
+        "props": [
+            {
+                "p": "payload"
+            },
+            {
+                "p": "topic",
+                "vt": "str"
+            }
+        ],
+        "repeat": "",
+        "crontab": "",
+        "once": false,
+        "onceDelay": 0.1,
+        "topic": "",
+        "payload": "48",
+        "payloadType": "num",
+        "x": 110,
+        "y": 620,
+        "wires": [
+            [
+                "ca4f27161c7f81fa"
+            ]
+        ]
+    },
+    {
+        "id": "669942032c75c052",
+        "type": "inject",
+        "z": "fc2acf2da9d1682c",
+        "name": "",
+        "props": [
+            {
+                "p": "payload"
+            },
+            {
+                "p": "topic",
+                "vt": "str"
+            }
+        ],
+        "repeat": "",
+        "crontab": "",
+        "once": false,
+        "onceDelay": 0.1,
+        "topic": "",
+        "payload": "55",
+        "payloadType": "num",
+        "x": 110,
+        "y": 660,
+        "wires": [
+            [
+                "ca4f27161c7f81fa"
+            ]
+        ]
+    },
+    {
+        "id": "2a1072fd3a5c4f1f",
+        "type": "inject",
+        "z": "fc2acf2da9d1682c",
+        "name": "",
+        "props": [
+            {
+                "p": "payload"
+            },
+            {
+                "p": "topic",
+                "vt": "str"
+            }
+        ],
+        "repeat": "",
+        "crontab": "",
+        "once": false,
+        "onceDelay": 0.1,
+        "topic": "",
+        "payload": "true",
+        "payloadType": "bool",
+        "x": 110,
+        "y": 720,
+        "wires": [
+            [
+                "94191a9675df61af"
+            ]
+        ]
+    },
+    {
+        "id": "6ba37de220dc855b",
+        "type": "inject",
+        "z": "fc2acf2da9d1682c",
+        "name": "",
+        "props": [
+            {
+                "p": "payload"
+            },
+            {
+                "p": "topic",
+                "vt": "str"
+            }
+        ],
+        "repeat": "",
+        "crontab": "",
+        "once": false,
+        "onceDelay": 0.1,
+        "topic": "",
+        "payload": "false",
+        "payloadType": "bool",
+        "x": 110,
+        "y": 760,
+        "wires": [
+            [
+                "94191a9675df61af"
+            ]
+        ]
+    },
+    {
+        "id": "70e5994a789dd73b",
+        "type": "geyserwala-connect-status",
+        "z": "fc2acf2da9d1682c",
+        "name": "Status",
+        "geyserwalaApi": "db6794008ea04dea",
+        "x": 390,
+        "y": 20,
+        "wires": [
+            [
+                "691616a2e1b3365d"
+            ]
+        ]
+    },
+    {
+        "id": "fba9a6ea6ed3f0cb",
+        "type": "geyserwala-connect-lowpower-enable",
+        "z": "fc2acf2da9d1682c",
+        "name": "Low Power Enable",
+        "geyserwalaApi": "db6794008ea04dea",
+        "x": 350,
+        "y": 260,
+        "wires": [
+            [
+                "cf52f2f9a6713b72"
+            ]
+        ]
+    },
+    {
+        "id": "db6794008ea04dea",
+        "type": "geyserwala-connect-api",
+        "name": "Geyserwala Connector",
+        "api": "MQTT",
+        "mqttBroker": "2f8be320790a3c93",
+        "mqttTopicTemplate": "geyserwala/%prefix%/%mac%",
+        "mqttTopicMac": "EFCDAB214365",
+        "mqttTopicIp": "",
+        "mqttTopicHostname": "",
+        "restHost": "192.168.1.55",
+        "restPort": "80",
+        "restUser": "admin",
+        "restPassword": "",
+        "restPollInterval": "3"
+    },
+    {
+        "id": "2f8be320790a3c93",
+        "type": "mqtt-broker",
+        "name": "MQTT Broker",
+        "broker": "192.168.1.5",
+        "port": "1883",
+        "clientid": "",
+        "autoConnect": true,
+        "usetls": false,
+        "protocolVersion": "4",
+        "keepalive": "60",
+        "cleansession": true,
+        "birthTopic": "",
+        "birthQos": "0",
+        "birthPayload": "",
+        "birthMsg": {},
+        "closeTopic": "",
+        "closeQos": "0",
+        "closePayload": "",
+        "closeMsg": {},
+        "willTopic": "",
+        "willQos": "0",
+        "willPayload": "",
+        "willMsg": {},
+        "userProps": "",
+        "sessionExpiry": ""
+    }
+]

package/package.json

@@ -0,0 +1,31 @@
+{
+    "name": "@thingwala/node-red-contrib-geyserwala-connect",
+    "version": "0.0.3",
+    "description": "Node-RED nodes for the Geyserwala Connect",
+    "author": "Thingwala",
+    "license": "MIT",
+    "homepage": "https://www.thingwala.com/geyserwala/connect",
+    "url" : "https://github.com/thingwala/node-red-contrib-geyserwala-connect/issues",
+    "dependencies": {
+        "mqtt": "^4.3.7"
+    },
+    "node-red": {
+        "version": ">=3.0.2",
+        "nodes": {
+            "api": "src/nodes/geyserwala-api.js",
+            "nodes": "src/nodes/geyserwala-nodes.js"
+        }
+    },
+    "keywords": [
+        "node-red",
+        "thingwala",
+        "geyserwala"
+    ],
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/thingwala/node-red-contrib-geyserwala-connect"
+    },
+    "engines": {
+        "node": ">=16.0.0"
+    }
+}

package/src/nodes/geyserwala-api-mqtt.js

@@ -0,0 +1,125 @@
+class GeyserwalaConnectorMqtt {
+    constructor(RED, broker, pubQos, retain, template, mac, ip, hostname) {
+        this.RED = RED
+        this.broker = broker
+        this.pubQos = pubQos
+        this.retain = retain
+        this.template = template.replace('%mac%', mac || 'MAC').replace('%ip%', ip || 'IP').replace('%hostname%', hostname || 'HOSTNAME')
+        this.subscriptions = {}
+        this.nodes = []
+
+        if (this.broker && !this.broker.client) {
+            this.broker.connect(() => {
+                this.setupBrokerEvents()
+            })
+        } else {
+            this.setupBrokerEvents();
+        }
+    }
+    setupBrokerEvents() {
+        if (this.broker && this.broker.client) {
+
+            this.status({ fill: "green", shape: "dot", text: "connected" });
+            for (const topic in this.subscriptions) {
+                this.subscribeTopic(topic)
+            }
+            this.broker.client.on("message", (topic, payload) => {
+                try {
+                    this.subscriptions[topic](payload)
+                } catch (error) {
+                    this.RED.log.error(`{Geyserwala Connect} Handling subscription: ${error.message}`);
+                }
+            });
+
+            this.broker.client.on("reconnect", () => {
+                this.status({ fill: "yellow", shape: "ring", text: "reconnecting" });
+            });
+
+            this.broker.client.on("offline", () => {
+                this.status({ fill: "red", shape: "ring", text: "offline" });
+            });
+
+            this.broker.client.on("close", () => {
+                this.status({ fill: "red", shape: "ring", text: "disconnected" });
+            });
+
+            this.broker.client.on("error", (error) => {
+                this.status({ fill: "red", shape: "ring", text: "error" });
+                this.RED.log.error(`{Geyserwala Connect} MQTT error: ${error}`);
+            });
+        } else {
+            this.status({ fill: "red", shape: "ring", text: "no broker" });
+            this.RED.log.error(`{Geyserwala Connect} No MQTT broker configuration found!`);
+        }
+    }
+    subTopic(key) {
+        return this.template.replace('%prefix%', 'stat') + `/${key}`;
+    }
+    pubTopic(key) {
+        return this.template.replace('%prefix%', 'cmnd') + `/${key}`;
+    }
+    subscribeTopic(topic) {
+        this.broker.client.subscribe(topic, (err) => {
+            if (err) {
+                this.RED.log.error(`{Geyserwala Connect} Subscribing to topic: ${topic}: ${err}`);
+            }
+        });
+    }
+    subscribe(key, type, onValue) {
+        let topic = this.subTopic(key)
+        this.subscriptions[topic] = (payload) => {
+            let msg = payload.toString()
+            let value
+            if (type === Number) {
+                value = parseInt(msg)
+            } else if (type === Boolean) {
+                value = msg == 'ON'
+            } else {
+                value = String(msg)
+            }
+            onValue(value)
+        }
+
+        if (this.broker && this.broker.client) {
+            this.subscribeTopic(topic)
+        }
+    }
+    unsubscribe(key) {
+        let topic = this.subTopic(key)
+
+        delete this.subscriptions[topic]
+        this.broker.client.unsubscribe(topic)
+    }
+    registerNode(node) {
+        this.nodes.push(node)
+    }
+    unregisterNode(node) {
+        this.nodes = this.nodes.filter((item) => {
+            return item !== node
+        })
+    }
+    status(blob) {
+        for (const node of this.nodes) {
+            node.status(blob)
+        }
+    }
+    send(key, value) {
+        let payload
+        if (typeof value === 'boolean') {
+            payload = value ? "ON" : "OFF"
+        } else {
+            payload = String(value)
+        }
+        const options = {
+            qos: this.pubQos,
+            retain: this.retain,
+        };
+        this.broker.client.publish(this.pubTopic(key), payload, options, (err) => {
+            if (err) {
+                this.RED.log.error(`{Geyserwala Connect} Publishing to MQTT: ${err}`);
+            }
+        });
+    }
+}
+
+module.exports = GeyserwalaConnectorMqtt;

package/src/nodes/geyserwala-api-rest.js

@@ -0,0 +1,227 @@
+const http = require('http');
+
+class GeyserwalaConnectorRest {
+    constructor(RED, host, port, user, password, pollInterval) {
+        this.RED = RED
+        this.host = host
+        this.port = port
+        this.user = user
+        this.password = password
+        this.req = null;
+        this.pollInterval = pollInterval
+        this.pollTimer = null;
+
+        this.subscriptions = {}
+        this.nodes = []
+        this.values = {}
+        this.backoff = 0
+        this.authToken = null;
+
+        this.startPollingWithBackoff();
+    }
+    subscribe(key, type, onValue) {
+        this.subscriptions[key] = onValue;
+    }
+    unsubscribe(key) {
+        delete this.subscriptions[key];
+    }
+    registerNode(node) {
+        this.nodes.push(node);
+    }
+    unregisterNode(node) {
+        this.nodes = this.nodes.filter((item) => {
+            return item !== node;
+        })
+    }
+    status(blob) {
+        for (const node of this.nodes) {
+            node.status(blob);
+        }
+    }
+    statusOnline(msg) {
+        this.status({ fill: "green", shape: "dot", text: msg || "online" });
+    }
+    statusOffline(msg) {
+        this.status({ fill: "red", shape: "ring", text: msg || "offline" });
+    }
+    updateValues(blob) {
+        for (const key in blob) {
+            try {
+                if (this.values[key] != blob[key]) {
+                    this.values[key] = blob[key];
+                    this.subscriptions[key](blob[key]);
+                }
+            }
+            catch (error) {
+                console.debug('No subscription', key);
+            }
+        }
+    }
+    startPolling(interval) {
+        if (this.pollTimer) {
+            clearTimeout(this.pollTimer);
+        }
+        this.pollTimer = setTimeout(
+            () => {
+                if (this.password && !this.authToken) {
+                    this.auth();
+                }
+                else {
+                    this.poll();
+                }
+            },
+            interval * 1000
+        );
+    }
+    startPollingAfterSuccess() {
+        this.backoff = 0;
+        this.startPolling(this.pollInterval);
+    }
+    startPollingWithBackoff() {
+        this.backoff ++;
+        let interval = Math.min(this.pollInterval * this.backoff, 60);
+        this.startPolling(interval);
+    }
+    stopPolling() {
+        if (this.req) {
+            this.req.destroy();
+            this.req = null;
+        }
+        if (this.pollTimer) {
+            clearTimeout(this.pollTimer);
+            this.pollTimer = null;
+        }
+    }
+    auth() {
+        this.stopPolling()
+        let blob = {username: this.user, password: this.password}
+        this.request(
+            'POST',
+            '/api/session',
+            blob,
+            (status, blob) => {
+                if (status == 200 && blob.success) {
+                    this.authToken = blob.token;
+                    this.statusOnline('auth success');
+                    this.startPollingAfterSuccess();
+                    return;
+                }
+                this.statusOffline('auth failed');
+                this.startPollingWithBackoff();
+            },
+            (error) => {
+                this.RED.log.error(`{Geyserwala Connect} Authing: ${error.message}`);
+                this.statusOffline(error.message);
+                this.startPollingWithBackoff();
+            }
+        )
+    }
+    poll() {
+        this.stopPolling()
+        this.request(
+            'GET',
+            '/api/value?f=' + Object.keys(this.subscriptions).join(','),
+            undefined,
+            (status, blob) => {
+                if (status == 200) {
+                    this.updateValues(blob);
+                    this.statusOnline()
+                    this.startPollingAfterSuccess();
+                    return;
+                } else if (status == 401){
+                    this.authToken = null;
+                    this.statusOffline('access denied')
+                }
+                else {
+                    this.statusOffline()
+                }
+                this.startPollingWithBackoff();    
+            },
+            (error) => {
+                // this.RED.log.error(`{Geyserwala Connect} Polling: ${error.message}`);
+                this.statusOffline(error.message);
+                this.startPollingWithBackoff();
+            }
+        )
+    }
+    send(key, value) {
+        this.stopPolling()
+        this.request('PATCH',
+            '/api/value',
+            { [key]: value },
+            (status, blob) => {
+                if (status == 200) {
+                    this.updateValues(blob)
+                    this.statusOnline()
+                    this.startPollingAfterSuccess();
+                    return
+                }
+                this.statusOffline()
+                this.startPollingWithBackoff();
+            },
+            (error) => {
+                this.RED.log.error(`{Geyserwala Connect} Patching: ${error.message}`);
+                this.statusOffline(error.message);
+                this.startPollingWithBackoff();
+            }
+        )
+    }
+    request(method, path, blob, success, fail) {
+        const http = require('http');
+
+        let requestBody = ''
+        if (blob) {
+            requestBody = JSON.stringify(blob)
+        }
+
+        const options = {
+            hostname: this.host,
+            port: this.port,
+            path: path,
+            method: method,
+            headers: {
+                'Content-Type': 'application/json',
+                'Content-Length': requestBody.length
+            }
+        };
+        if (this.authToken) {
+            options.headers['Authorization'] = `Bearer ${this.authToken}`
+        }
+
+        this.req = http.request(options, (res) => {
+            let responseBody = [];
+
+            res.on('data', (chunk) => {
+                responseBody.push(chunk);
+            });
+
+            res.on('end', () => {
+                try {
+                    let blob = JSON.parse(Buffer.concat(responseBody).toString());
+                    this.req = null
+                    success(res.statusCode, blob)
+                }
+                catch(error) {
+                    this.RED.log.error(`{Geyserwala Connect} Request failed: ${error.message}`)
+                    fail(error);
+                }
+            });
+        });
+        this.req.setTimeout(10000, () => {
+            this.req.abort();
+            fail({message: "Request timed out"});
+        });
+        this.req.on('abort', () => {
+            // console.debug('Request aborted.');
+        });
+        this.req.on('error', (error) => {
+            this.req = null;
+            fail(error);
+        });
+
+        this.req.write(requestBody);
+        this.req.end();
+    }
+}
+
+module.exports = GeyserwalaConnectorRest;

package/src/nodes/geyserwala-api.html

@@ -0,0 +1,137 @@
+<script type="text/javascript">
+    RED.nodes.registerType('geyserwala-connect-api', {
+        category: 'config',
+        paletteLabel: 'Geyserwala Connector',
+        defaults: {
+            name: { value: "Geyserwala", required: true },
+
+            api: { value: "MQTT", requred: true },
+
+            mqttBroker: { type: "mqtt-broker" },
+            mqttPubQos: { value: 0 },
+            mqttRetain: { value: false },
+            mqttTopicTemplate: { value: "geyserwala/%prefix%/%mac%" },
+            mqttTopicMac: { value: "" },
+            mqttTopicIp: { value: "" },
+            mqttTopicHostname: { value: "" },
+
+            restHost: { value: "" },
+            restPort: { value: 80 },
+            restUser: { value: "admin" },
+            restPassword: { value: "" },
+            restPollInterval: { value: 3 },
+        },
+        label: function () {
+            return this.name;
+        }
+    });
+
+    function showConfigFields(value) {
+        document.getElementById('config-api-mqtt').style.display = (value == 'MQTT' ? "" : "none");
+        document.getElementById('config-api-rest').style.display = (value == 'REST' ? "" : "none");
+    }
+
+</script>
+
+<script type="text/x-red" data-template-name="geyserwala-connect-api">
+    <div class="form-row">
+        <h4>Geyserwala Connect : API Connector</h4>
+    </div>
+    <div class="form-row">
+        <label for="node-config-input-name"><i class="fa fa-tag"></i> Name</label>
+        <input type="text" id="node-config-input-name" placeholder="Name">
+    </div>
+    <div class="form-row">
+        <label for="node-config-input-api"><i class="fa fa-link"></i> API</label>
+        <select id="node-config-input-api" style="width:20%;" onchange="showConfigFields(this.value)">
+            <option value="MQTT">MQTT</option>
+            <option value="REST">REST</option>
+        </select>
+    </div>
+
+    <fieldset id="config-api-mqtt">
+        <legend>MQTT Configuration</legend>
+        <div class="form-row">
+            <label for="node-config-input-mqttBroker"><i class="fa fa-server"></i> Broker</label>
+            <input type="text" id="node-config-input-mqttBroker">
+        </div>
+        <div class="form-row">
+<!-- 
+            <div class="form-row-column">
+                <label for="node-config-input-mqttPubQos"><i class="fa fa-exclamation"></i> QoS</label>
+                <select id="node-config-input-mqttPubQos" style="width:30%;">
+                    <option value="0">0</option>
+                    <option value="1">1</option>
+                    <option value="2">2</option>
+                </select>
+            </div>
+            <div class="form-row-column">
+                <label for="node-config-input-mqttRetain"><i class="fa fa-sticky-note-o"></i> Retain</label>
+                <select id="node-config-input-mqttRetain" style="width:30%;">
+                    <option value="0">false</option>
+                    <option value="1">true</option>
+                </select>
+            </div>
+ -->
+        </div>
+        <div style="border: 1px solid #ccc; border-radius: 5px; padding: 10px 5px 5px 10px">
+            <div class="form-row">
+                <label for="node-config-input-mqttTopicTemplate"><i class="fa fa-code"></i> Topic Template</label>
+                <input type="text" id="node-config-input-mqttTopicTemplate" placeholder="geyserwala/%prefix%/%mac%" pattern="^[a-zA-Z\d%\/]{1,80}?$">
+            </div>
+                <h4>Tokens</h4>
+                <p>These take the form of <b>%name%</b>, see <a href="https://github.com/thingwala/geyserwala-connect/blob/main/docs/MQTT.md" target="_blank">the docs</a>.
+            <div class="form-row">
+                <label for="node-config-input-mqttTopicMac"><i class="fa fa-ticket"></i>&nbsp;prefix</label>
+                <p>Required: will be either <b>stat</b> or <b>cmnd</b></p>.
+            </div>
+            <div class="form-row">
+                <label for="node-config-input-mqttTopicMac"><i class="fa fa-ticket"></i>&nbsp;mac</label>
+                <input type="text" id="node-config-input-mqttTopicMac" style="width:30%;" placeholder="EFCDAB214365" pattern="^[A-F\d]{12}?$">
+            </div>
+            <div class="form-row">
+                <label for="node-config-input-mqttTopicIp"><i class="fa fa-ticket"></i>&nbsp;ip</label>
+                <input type="text" id="node-config-input-mqttTopicIp" style="width:40%;" placeholder="192.168.1.5" pattern="^(?:[0-9]{1,3}\.){3}[0-9]{1,3}$">
+            </div>
+            <div class="form-row">
+                <label for="node-config-input-mqttTopicHostname"><i class="fa fa-ticket"></i>&nbsp;hostname</label>
+                <input type="text" id="node-config-input-mqttTopicHostname" style="width:40%;" placeholder="geyserwala" pattern="^[A-F\d]{1,80}?$">
+            </div>
+        </div>
+    
+    </fieldset>
+
+    <fieldset id="config-api-rest">
+        <legend>REST Configuration</legend>
+
+        <div class="form-row">
+            <label for="node-config-input-restHost"><i class="fa fa-server"></i> Host</label>
+            <input type="text" id="node-config-input-restHost" placeholder="192.168.1.5">
+        </div>
+        <div class="form-row">
+            <label for="node-config-input-restPort"><i class="fa fa-dot-circle-o"></i> Port</label>
+            <input type="number" id="node-config-input-restPort" style="width:15%;" placeholder="80" min=1 max=65535>
+        </div>
+        <div class="form-row">
+            <label for="node-config-input-restUser"><i class="fa fa-user"></i> User</label>
+            <input type="text" id="node-config-input-restUser" style="width:40%;" placeholder="admin">
+        </div>
+        <div class="form-row">
+            <label for="node-config-input-restPassword"><i class="fa fa-key"></i> Password</label>
+            <input type="password" id="node-config-input-restPassword" style="width:40%;" placeholder="">
+        </div>
+        <div class="form-row">
+            <label for="node-config-input-restPollInterval"><i class="fa fa-hourglass-o"></i> Poll Interval</label>
+            <input type="number" id="node-config-input-restPollInterval" style="width:15%;" placeholder="3" min=1 max=300><span>&nbsp;seconds</span>
+        </div>
+    </fieldset>
+    <style>
+        .form-row {
+            display: flex;
+        }
+        .form-row-column {
+            flex: 1;
+            margin-right: 10px;
+        }
+    </style>
+</script>

package/src/nodes/geyserwala-api.js

@@ -0,0 +1,31 @@
+
+module.exports = function (RED) {
+    function Node(config) {
+        RED.nodes.createNode(this, config);
+
+        if (config.api == 'MQTT') {
+            const GeyserwalaConnectorMqtt = require('./geyserwala-api-mqtt');
+
+            this.api = new GeyserwalaConnectorMqtt(RED,
+                RED.nodes.getNode(config.mqttBroker),
+                config.mqttPubQos,
+                config.mqttRetain,
+                config.mqttTopicTemplate,
+                config.mqttTopicMac,
+                config.mqttTopicIP,
+                config.mqttTopicHostname
+            );
+        } else if (config.api == "REST") {
+            const GeyserwalaConnectorRest = require('./geyserwala-api-rest');
+
+            this.api = new GeyserwalaConnectorRest(RED,
+                config.restHost,
+                config.restPort,
+                config.restUser,
+                config.restPassword,
+                config.restPollInterval,
+            )
+        }
+    }
+    RED.nodes.registerType("geyserwala-connect-api", Node);
+};

package/src/nodes/geyserwala-nodes.html

@@ -0,0 +1,60 @@
+<script type="text/template" id="node-input-template">
+    <div class="form-row">
+        <h4 id="title"></h4>
+    </div>
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
+        <input type="text" id="node-input-name" placeholder="Name">
+    </div>
+    <div class="form-row">
+        <label for="node-input-geyserwalaApi"><i class="fa fa-link"></i> Geyserwala</label>
+        <input type="text" id="node-input-geyserwalaApi">
+    </div>
+</script>
+
+<script type="text/javascript">
+    function addInputDialog(valueKey, nodeLabel) {
+        var nodeInput = $("#node-input-template").clone().html();
+
+        var scriptTag = $("<script>").attr("type", "text/x-red").attr("data-template-name", `geyserwala-connect-${valueKey}`).append(nodeInput);
+        scriptTag.find('#title').text(`Geyserwala Connect : ${nodeLabel}`);
+        $('body').append(scriptTag.prop('outerHTML'));
+    }
+
+    function registerType(valueKey, nodeLabel, icon, input) {
+        addInputDialog(valueKey, nodeLabel)
+        
+        RED.nodes.registerType(`geyserwala-connect-${valueKey}`, {
+            category: 'Geyserwala Connect',
+            paletteLabel: nodeLabel,
+            defaults: {
+                name: { value: nodeLabel },
+                geyserwalaApi: { type: "geyserwala-connect-api", required: true },
+            },
+            inputs: input ? 1 : 0,
+            outputs: 1,
+            color: "#2AAED7",
+            icon: icon,
+            label: function () {
+                return this.name;
+            }
+        });
+    }
+
+    // Icons: https://fontawesome.com/v4/icons/
+    registerType('tank-temp', "Tank Temp", "font-awesome/fa-thermometer-half", false);
+    registerType('element-demand', "Element Demand", "font-awesome/fa-fire", false);
+
+    registerType('lowpower-enable', "Low Power Enable", "font-awesome/fa-stop-circle-o", true);
+    registerType('external-demand', "External Demand", "serial.png", true);
+    registerType('external-setpoint', "External Setpoint", "inject.png", true);
+
+    registerType('status', "Status", "font-awesome/fa-envelope-o", true);
+    registerType('mode', "Mode", "font-awesome/fa-info", true);
+    registerType('setpoint', "Setpoint", "inject.png", true);
+    registerType('boost-demand', "Boost Demand", "font-awesome/fa-power-off", true);
+
+    registerType('collector-temp', "Collector Temp", "font-awesome/fa-thermometer-half", false);
+    registerType('pump-status', "Pump Status", "font-awesome/fa-recycle", false);
+
+</script>

package/src/nodes/geyserwala-nodes.js

@@ -0,0 +1,62 @@
+module.exports = function (RED) {
+    function createNode (valueKey, type, input) {
+        function Node(config) {
+            RED.nodes.createNode(this, config);
+
+            var geyserwalaApi = RED.nodes.getNode(config.geyserwalaApi)
+            if (!geyserwalaApi) {
+                this.error('Connector not configured')
+                return
+            }
+            this.api = geyserwalaApi.api;
+            if (!geyserwalaApi.api) {
+                this.error('Invalid Connector')
+                return
+            }
+
+            this.api.registerNode(this)
+
+            this.api.subscribe(valueKey, type, (payload) => {
+                try {
+                    this.send({ topic: valueKey, payload: payload })
+                } catch (error) {
+                    RED.log.error(`{Geyserwala Connect} Outputing: ${error.message}`);
+                }
+            });
+            this.on('close', () => {
+                this.api.unsubscribe(valueKey);
+                this.api.unregister(this);
+            });
+
+            if (input) {
+                this.on('input', function (message) {
+                    try {
+                        this.api.send(valueKey, message.payload)
+                    } catch (error) {
+                        RED.log.error(`{Geyserwala Connect} Sending: ${error.message}`);
+                    }
+                })
+            }
+            this.on('close', function () {
+                this.api.unregister(this);
+            });
+        }
+
+        RED.nodes.registerType(`geyserwala-connect-${valueKey}`, Node);
+    }
+
+    createNode('tank-temp', Number, false);
+    createNode('element-demand', Boolean, false);
+
+    createNode('lowpower-enable', Boolean, true);
+    createNode('external-demand', Boolean, true);
+    createNode('external-setpoint', Number, true);
+
+    createNode('status', String, false);
+    createNode('mode', String, true);
+    createNode('setpoint', Number, true);
+    createNode('boost-demand', Boolean, true);
+
+    createNode('collector-temp', Number, false);
+    createNode('pump-status', Boolean, false);
+}