https://github.com/nielstron/pyfronius

Automated JSON API based communication with Fronius Symo
https://github.com/nielstron/pyfronius

fronius iot json python3

Last synced: 1 day ago
JSON representation

Automated JSON API based communication with Fronius Symo

• Host: GitHub
• URL: https://github.com/nielstron/pyfronius
• Owner: nielstron
• License: mit
• Created: 2021-12-01T11:10:22.000Z (about 3 years ago)
• Default Branch: master
• Last Pushed: 2024-02-04T09:11:48.000Z (about 1 year ago)
• Last Synced: 2025-01-28T21:22:15.265Z (17 days ago)
• Topics: fronius, iot, json, python3
• Language: Python
• Homepage:
• Size: 168 KB
• Stars: 26
• Watchers: 5
• Forks: 9
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# PyFronius - a very basic Fronius python bridge

[![Build Status](https://app.travis-ci.com/nielstron/pyfronius.svg?branch=master)](https://app.travis-ci.com/nielstron/pyfronius)

[![Coverage Status](https://coveralls.io/repos/github/nielstron/pyfronius/badge.svg?branch=master)](https://coveralls.io/github/nielstron/pyfronius?branch=master)

 [![PyPI version](https://badge.fury.io/py/PyFronius.svg)](https://pypi.org/project/pyfronius/)

 ![PyPI - Python Version](https://img.shields.io/pypi/pyversions/PyFronius.svg)

 [![PyPI - Status](https://img.shields.io/pypi/status/PyFronius.svg)](https://pypi.org/project/pyfronius/)

A package that connects to a Fronius device in the local network and provides data

that is provided via the JSON API of the Fronius.

This includes the grid consumption, grid return, photovoltaic production

and many more details on the status of the local power supply.

> This package is looking for maintainers. I do not own a Fronius device anymore and cannot test the package.

> If you are interested in maintaining this package, please contact me.

## Features 

The package supports the following data provided by Fronius devices:

- Power Flow (System scope)

- Meter (System and Device scope)

- Inverter (System and Device scope)

- Storage (System and Device scope, Experimental) 

- Active Devices

- Logger Information

- Inverter Information

The package currently supportes the Fronius API V1 and V0

and aims to support as many different device types as possible (Hybrid, GEN24,...).

I also know there are better scripts, yet they are not on pypi which is necessary

for using them with [Home Assistant](https://www.home-assistant.io)

## Contributing

Support may be enhanced based on the official documentation ([V1](https://www.fronius.com/~/downloads/Solar%20Energy/Operating%20Instructions/42%2C0410%2C2012.pdf), [V0](https://www.fronius.com/~/downloads/Solar%20Energy/Operating%20Instructions/42,0410,2011.pdf)).

Pull requests are very welcome.

If you own a Fronius device, feel free to provide us with raw data returned

by fetching the API endpoints manually.

Data from systems featuring Ohmpilots and Storages are much welcomed as we

have no data for testing these so far.