Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

node-fronius-solar

mwittig113MIT0.0.10

Access PV live logs using the Fronius Solar API

Fronius, Solar API, Photovoltaics, SmartHome, SmartMeter, Volkszaehler, Monitoring

readme

node-fronius-solar

Greenkeeper badge Build Status

Access PV live logs using the Fronius Solar API V0 and V1.

Usage Example

var fronius = require('node-fronius-solar'),
    util = require('util'),
    options = {
        host: 'localhost',
        port: 8001,
        deviceId: 1
        version: 0
    },
    x = Date.now();

// This is the Solar API V0 call which should work with Fronius Datalogger Web v2.0.4.1 (and higher) and
// Fronius Data Manager v3.0.3-1 (and higher)
fronius.GetInverterRealtimeData(options).then(function (json) {
    console.log(util.inspect(json, { depth: 4, colors : true }));
    console.log(Date.now() - x, "milliseconds elapsed")
}).catch(function(e) {console.log(e)});

// This is the Solar API V1
options.version = 1;
fronius.GetInverterRealtimeData(options).then(function (json) {
    console.log(util.inspect(json, { depth: 4, colors : true }));
    console.log(Date.now() - x, "milliseconds elapsed")
}).catch(function(e) {console.log(e)});

// GetComponentsData is provided to use an undocumented API service of the Fronius Data Manager
// provided with the Symo inverters. See https://forum.fhem.de/index.php/topic,24614.msg214011.html#msg214011
// In contrast to the regular Solar API Calls which do not require authentication, you may need to provide
// username and password properties to the options dictionary (if authentication has been enabled 
// for Fronius Data Manager.
fronius.GetComponentsData(options).then(function (json) {
    console.log(util.inspect(json, { depth: 4, colors : true }));
    console.log(Date.now() - x, "milliseconds elapsed")
}).catch(function(e) {console.log(e)});

// This is a Solar API V1 call which should work with Fronius Data Manager v3.4.2-1 (and higher)
fronius.GetPowerFlowRealtimeDataData(options).then(function (json) {
    console.log(util.inspect(json, { depth: 4, colors : true }));
    console.log(Date.now() - x, "milliseconds elapsed")
}).catch(function(e) {console.log(e)});

Release History

See Release History.

License

Copyright (c) 2016, Marcus Wittig and contributors. All rights reserved.

MIT License.

changelog

Release History

  • 20150512, V0.0.1

    • Initial Version
  • 20150514, V0.0.2

    • Improved error handling
    • Added support for HTTPS, added rejectUnauthorized: false to allow self-signed server certs. Should be set to true if server has a certificate signed from a trusted CA
  • 20150518, V0.0.3

    • Improved error handling
  • 20160305, V0.0.4

    • Updated dependencies
    • Replaced deprecated usage of Promise.settle() function
    • Added travis build descriptor
  • 20160318, V0.0.5

    • Added GetComponentsData() for using an undocumented API service provided by the data logger of the Symo inverters. Issue #1
    • Moved server.js to 'test' directory as a starting pointed for automating testing
    • Updated dependencies
  • 20160330, V0.0.6

    • Added HTTP-Digest Authentication as required for GetComponentsData if authentication has been enabled for Fronius Data Manager
    • Added GetPowerFlowRealtimeDataData() Solar API V1 service call
    • Moved release history to separate file
    • Added license info to README
  • 20160601, V0.0.7

    • Added basic support for V0 GetInverterRealtimeData
  • 20160601, V0.0.8

    • Bug fix for V0 GetInverterRealtimeData
  • 20160921, V0.0.9

    • Updated dependencies
  • 20170929, V0.0.10

    • Updated dependencies
    • Added Greenkeeper badge