@mschaeffler/node-red-fenecon 1.1.0

Node Red nodes to communicate with a Fenecon FEMS

npm install @mschaeffler/node-red-fenecon

@mschaeffler/node-red-fenecon

Node Red nodes to communicate with a Fenecon FEMS.

image of example flow

image of example flow

Install

$ npm install @mschaeffler/node-red-fenecon

feneconFems Node

This node contains the configuration data for the connection to the FEMS.

Parameters

config type description
Hostname string hostname of the FEMS

feneconHttpGet Node

A Node Red node to request one ore more data points from a Fenecon FEMS.

Input

msg. type description
topic string data point to be requested

Data Points

The data points of the FEMS are always named as group/name. You can get all possible data points with the request .*/.*.

Examples:

  • .*/.*
  • _meta/V.*
  • _meta/Version
  • ctrlGridOptimizedCharge0/(DelayChargeMaximumChargeLimit|_PropertyManualTargetTime)

Output

msg. type description
topic string same as in input.
payload value or object received data points. If more than one data point is returned, it is an object with key/value pairs.

Parameters

config type description
Fems feneconFems configuration of the FEMS.
Topic string the data point to request; if empty, msg.topic will be used.
Complete boolean sending out the complete response data or just the value.

feneconHttpPost node

A Node Red node to set data points at a Fenecon FEMS with the App "Schreibzugriff".

Input

msg. type description
topic string data point to be written
payload number value to be written

Data Points

The data points of the FEMS are always named as group/name. You can find the writable data points at the FEMS documentation.

Examples:

  • ess0/SetActivePowerEquals
  • ess0/SetActivePowerLessOrEquals
  • ess0/SetActivePowerGreaterOrEquals

Parameters

config type description
Fems feneconFems configuration of the FEMS.
Topic string the data point to set; if empty, msg.topic will be used.

feneconWebsocket node

A Node Red node to subscribe data points and configuration data at a Fenecon FEMS via the WebSocket interface similar to the web UI.

It is also possible to write config data. This can be dangerous and damage your FEMS! This is done at your own risk! Please be careful and we accept no responsibility whatsoever for a damaged FEMS!

Input

msg. type description
topic string open, close or name of the config parameter to be written
payload number value of the config parameter to be written

Outputs

subscribed data

Cyclic output of the subscribed data points.

msg. type description
payload object received data points. It is an object with key/value pairs.

config data

Config data of the FEMS.

msg. type description
payload object received config data.

state

Actual state of the websocket connection.

msg. type description
payload string state of the websocket.

Parameters

config type description
Fems feneconFems configuration of the FEMS.
Edge string id of the edge; normally "0".
Inlist array list of subscribed data points.
Risk boolean risk accepted, enables writing.
Timeout boolean send "timeout" as state, if 10s no subscribed message arrives.

Data Points

The data points of the FEMS are always named as group/name. You can find possible data points at FEMS documentation.

Example inlist:

[
    "_sum/State",
    "_sum/GridMode",
    "_sum/EssSoc",
    "_sum/ProductionActivePower",
    "_sum/EssDischargePower",
    "_sum/GridActivePower",
    "_sum/GridSellActiveEnergy",
    "_sum/GridBuyActiveEnergy",
    "_sum/ProductionActiveEnergy",
    "_sum/EssDcDischargeEnergy",
    "_sum/EssDcChargeEnergy",
    "batteryInverter0/AirTemperature",
    "batteryInverter0/RadiatorTemperature",
    "ctrlIoHeatPump0/Status",
    "charger0/ActualPower",
    "charger1/ActualPower",
    "ctrlGridOptimizedCharge0/DelayChargeState",
    "meter0/CurrentL1",
    "meter0/CurrentL2",
    "meter0/CurrentL3"
]

feneconConnMan node

A Node Red node to manage the state of a feneconWebsocket node.

Input

msg. type description
payload string state message from feneconWebsocket node.

Output

msg. type description
topic string open command for a feneconWebsocket node.

Parameters

config type description
cyclic number cyclic time of the manager in s; 15s is here the recommended value.

Example Flow

HTTP API

WebSocket API

Author

Mathias Schäffler

License

LGPL-2.1

Node Info

Version: 1.1.0
Updated 16 hours ago
License: LGPL-2.1
Rating: not yet rated
View on npm
View on GitHub
View Scorecard 11 1

Categories

Actions

Rate:

Downloads

134 in the last week

Nodes

  • feneconFems
  • feneconHttpGet
  • feneconHttpPost
  • feneconWebsocket
  • feneconConnMan

Keywords

  • node-red
  • Fenecon
  • FEMS
  • OpenEMS

Maintainers