Fork me on GitHub

pimatic-volkszaehler by Andreas Goetz | github | npm

pimatic volkszaehler plugin

Volkszaehler plugin enables connecting the volkszaehler.org smart meter application to pimatic automation server.

Plugin Configuration

You can load the plugin by editing your config.json to include:

{
    "plugin": "volkszaehler",
    "middleware": "http://127.0.0.1/middleware.php", // url of the volkszaehler middleware
    "interval": 60 // Polling interval. Inherited from plugin if not defined.
    "mode": ["push", "pull"] // Update mode. Default is pull
}

The middleware url is needed to retrieve the volkszaehler installation's capabilities, especially the entity type definitions.

NOTE currently, volkszahler master branch does not contain the needed patches to push data to pimatic. Make sure that

"mode": "pull"

as long as you're running a Volkszaehler version with API version <= 0.3

Device Configuration

Devices are linked to volkszaehler channels by specifying the class, middleware and uuid properties:

...
"devices": [
{
    "id": "home-bezug",
    "name": "Kanal 1",
    "class": "Volkszaehler",
    "uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx"
    // optional attributes - inherited from plugin if not defined
    "middleware": "http://127.0.0.1/middleware.php", // Url of the device's middleware
    "mode": ["push", "pull"] // Update mode
    "interval": 60 // Polling interval if mode == pull
},
...

As middleware can be configured per device, multiple volkszaehler installations can be connected as long as their capabiltiies match. If middleware is not configured, it will be inherited from the plugin settings.

Plugin Config Options

Volkszaehler plugin config options
OptionDescriptionDefault
middleware
string
Middleware URL
"http://127.0.0.1/middleware.php"
mode
string
Connection mode for middleware
"pull"
interval
number
Polling interval for channel updates in seconds when mode == pull
60

Device Config Options

Volkszaehler

Volkszaehler

Volkszaehler channel
OptionDescriptionDefault
middleware
string
Middleware URL
""
mode
string
Connection mode for middleware
""
interval
number
Polling interval for channel updates in seconds when mode == pull
0
uuid
string
Channel UUID
pimatic-volkszaehler is written by Andreas Goetz