/node-red-contrib-power-monitor

A Node-RED node to monitor home appliances based on their power consumption.

Primary LanguageJavaScriptOtherNOASSERTION

node-red-contrib-power-monitor

GitHub version NPM version Dependencies Status
donate twitter

A Node-RED node to monitor home appliances based on their power consumption.

Table of Contents

Install

Run the following command in your Node-RED user directory - typically ~/.node-red:

npm install node-red-contrib-power-monitor

Usage

Feed the node regularly with a real number as payload representing the average consumption in Watts since the last message. The node will trigger events based on the start and stop conditions with additional information like the total energy consumption for the last cycle.

Configuration

  • Name: Name of the appliance. Will be attached to the output object.
  • Start threshold: Value (in watts) to tell whether the appliance is running, an ideal value would be 0 (0W if not running).
  • Start after: Number of messages with readings over the threshold to trigger a start event.
  • Stop threshold: Value (in watts) to tell whether the appliance has finished, an ideal value would be 0 (0W if not running).
  • Stop after: Number of messages with readings below the threshold to trigger a stop event.

Output

The output will be a JSON object with the appliance name and the event type.

  • In case the event is a pre_start or running event, it will also report the current running time (in seconds) and the current energy consumption of the cycle (in kWh) since it started, as well as the energy_delta in kWh since last update.
  • In case the event is a stop event, it will also report the total time (in seconds) and the total energy consumption of the cycle (in kWh).

Examples:

{ "name": "washer", "event": "start", "time": 0, "energy": 0, "energy_delta": 0 }

{ "name": "washer", "event": "pre_start", "time": 100, "energy": 0.003, "energy_delta": 0.002 }

{ "name": "washer", "event": "running", "time": 4500, "energy": 0.05, "energy_delta": 0.009 }

{ "name": "washer", "event": "stop", "time": 8800, "energy": 0.14, "energy_delta": 0.020 }

Contribute

There are several ways to contribute to this project. You can report bugs or ask for new features directly on GitHub. You can also submit your own new features of bug fixes via a pull request.

And of course you can always buy me a beer, coffee, tea,... via the donation button below.

donate

License

This project is licensed under Apache 2.0 license.