1
0
mirror of https://github.com/node-red/node-red-nodes.git synced 2023-10-10 13:36:58 +02:00
node-red-nodes/function/rbe
Dave Conway-Jones 6c3dbbbfbb Update RBE to add object compare
and narrowband mode (thanks @nlecaude for the idea)
2016-02-02 13:39:37 +00:00
..
icons fatten up rbe icon slightly 2015-08-11 19:56:23 +01:00
locales/en-US Update RBE to add object compare 2016-02-02 13:39:37 +00:00
LICENSE Add simple RBE node 2015-01-23 13:34:10 +00:00
package.json Update RBE to add object compare 2016-02-02 13:39:37 +00:00
rbe.html Update RBE to add object compare 2016-02-02 13:39:37 +00:00
rbe.js Update RBE to add object compare 2016-02-02 13:39:37 +00:00
README.md bump package versions of i18n nodes 2015-07-14 23:03:46 +01:00

node-red-node-rbe

A Node-RED node that provides provides report-by-exception (RBE) and deadband capability.

The node blocks unless the incoming value changes - RBE mode, or changes by more than a certain amount (absolute value or percentage) - deadband mode.

Install

Run the following command in your Node-RED install directory, usually ~/.node-red

npm install node-red-node-rbe

Usage

A simple node to provide report by exception (RBE) and deadband function

  • only passes on data if it has changed.

This works on a per msg.topic basis. This means that a single rbe node can handle multiple topics at the same time.

###RBE mode

The node doesn't send any output until the msg.payload is different to the previous one. Works on numbers and strings. Useful for filtering out repeated messages of the same value. Saves bandwidth, etc...

###Deadband mode

In deadband mode the incoming payload should contain a parseable number and is output only if greater than + or - the band gap away from the previous output.

The deadband value can be specified as a fixed number, or a percentage. E.g. 10 or 5% . If % mode is used then the output will only get sent if the input payload value is equal or more than the specified % away from the previously sent value.

For example - if last sent value was 100, and deadband is set to 10% - a value of 110 will pass - then the next value has to be 121 in order to pass (= 110 + 10% = 121).

This is mainly useful if you want to operate across multiple topics at the same time that may have widely differing input ranges.

Will only accept numbers, or parseable strings like "18.4 C" or "$500"