Skip to main content

zeversolarlocal

Project description

Code style: black PyPI codecov

zeversolarlocal

Access solar energy data from your local Zeversolar inverter.

Principle

This library accesses the home.cgi endpoint which returns a bytes object, which is parsed returning current power generation and the daily generated energy. The inverter is powered by the solar energy generated by the connected solar panels. This means that some generated errors can mean different things depending on circumstances.

If the inverter cannot be reached a ZeverTimeout is raised. Which could mean:

  1. The ip-address of the inverter is wrong.
  2. The inverter is switched off (no solar power). But can be considered expected behavior.

If returning data cannot be parsed properly a ZeverError is raised. Which could mean:

  1. The returned data is wrong and is indeed an error.
  2. Sometimes some other data is returned (which meaning is currently unknown), which cannot be parsed, but everything else is fine.

installation

pip install zeversolarlocal

usage

import asyncio
import zeversolarlocal

loop = asyncio.get_event_loop()

def get():

    address = "192.168.1.12"  # ip address of your zeversolar inverter.
    url = zeversolarlocal.default_url(address)
    
    solar_data = loop.run_until_complete(zeversolarlocal.solardata(url))

    print(solar_data)

CLI

from the commandline use:

python -m zeversolarlocal 192.168.1.12

Changelog

1.0.0

  • First release

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

zeversolarlocal-1.1.0.tar.gz (21.5 kB view hashes)

Uploaded Source

Built Distribution

zeversolarlocal-1.1.0-py3-none-any.whl (4.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page