solaredge-interface 0.3.2

The SolarEdge Interface provides both a command-line interface and a Python module interface to interact with the SolarEdge API service.

SolarEdge Interface

The SolarEdge Interface provides both a command-line interface and a Python module interface to interact with the SolarEdge API service.

Features

• All (documented) SolarEdge API endpoints are implemented with multisite support for endpoints that provide multisite queries.
• Response data for all endpoints are available as a Python-dict structure; a Pandas-DataFrame or; as raw-JSON.
• The command-line interface output can be formatted as a CSV; as a Pandas style JSON structure or; as plain-JSON.
• Timestamps can be returned as datetime values with their respective site timezones applied. Doing so is the default behaviour, however this can be disabled if required.
• Configuration via environment variables or config file is possible, thus making it safer to manage your API key value(s).
• Decent debug logging to help detect and discover problems should they arise.
• Easy installation using PyPI pip
• Plenty of documentation and examples - https://solaredge-interface.readthedocs.io

Installation

user@computer:~$ pip3 install solaredge-interface

Command Line Usage

For example, obtain the current power flow at site 1234567. This assumes the API_KEY has been set using the SOLAREDGE_API_KEY environment variable; alternatively use the --config command parameter to load a configuration file. Response data in CSV format for all sub-commands can be achieved by adding --format csv

user@computer:~$ solaredge-interface site_current_power_flow 1234567
{
  "siteCurrentPowerFlow": {
    "updateRefreshRate": 3,
    "unit": "kW",
    "connections": [
      {
        "from": "GRID",
        "to": "Load"
      }
    ],
    "GRID": {
      "status": "Active",
      "currentPower": 0.7
    },
    "LOAD": {
      "status": "Active",
      "currentPower": 0.7
    },
    "PV": {
      "status": "Idle",
      "currentPower": 0.0
    }
  }
}

Plenty more command-line examples available here.

Python Module Usage

Python 3.8.5 (default, Jul 28 2020, 12:59:40) 
[GCC 9.3.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>>
>>> from solaredge_interface.api.SolarEdgeAPI import SolarEdgeAPI
>>> api = SolarEdgeAPI(api_key='XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX', datetime_response=True, pandas_response=True)
>>> response = api.get_site_current_power_flow(1234567)
>>> response.data
{'siteCurrentPowerFlow': {'updateRefreshRate': 3, 'unit': 'kW', 'connections': [{'from': 'GRID', 'to': 'Load'}], 'GRID': {'status': 'Active', 'currentPower': 0.7}, 'LOAD': {'status': 'Active', 'currentPower': 0.7}, 'PV': {'status': 'Idle', 'currentPower': 0.0}}}
>>>

Additional Python-module examples are available in the python-modules pages.

History

This project started as a fork from EnergieID which was renamed to solaredge-interface because it was heavily re-worked and extended in a way that is not compatible with previous forks.

• 2020-10-11 - forked to ndejong/solaredge-interface
• 2018-01-26 - forked to EnergieID/solaredge
• 2017-11-28 - original bertouttier/solaredge

Project

• Github - github.com/ndejong/solaredge-interface
• PyPI - pypi.python.org/pypi/solaredge-interface
• TravisCI - travis-ci.org/github/ndejong/solaredge-interface
• ReadTheDocs - solaredge-interface.readthedocs.io

---

Copyright © 2020 Nicholas de Jong