/sunsynk

Deye/Sunsynk Inverter Python library and Home Assistant OS Addon

Primary LanguagePythonMIT LicenseMIT

Deye/Sunsynk Inverters

This repo enables access to Deye Hybrid Inverters & Deye branded inverters like Sunsynk through a Python 3 library. It also provides an Add-On that can be installed in the Home Assistant OS.

This code was developed on a Sunsynk 5.5 kWh inverter.

DISCLAIMER: Use at your own risk! Especially when writing any settings.

Documentation

Refer to https://kellerza.github.io/sunsynk/

Home Assistant Sunsynk Add-On

For the Add-On you require Home Assistant OS and a RS-485 adaptor to connect to your Sunsynk inverter. Sensors are read using the Modbus protocol and sent to a MQTT server. See deployment options for examples of tested hardware.

Installation

  1. Add this repository to your HA Supervisor

    Open your Home Assistant instance and show the add add-on repository dialog with a specific repository URL pre-filled.

    https://github.com/kellerza/sunsynk

  2. Install the Sunsynk Add-On from the Add-On Store and configure through the UI

    Install Sunsynk Addon

Below an example of the HomeAssistant Energy management dashboard using sensors from the Sunsynk.

HASS Energy management

Sunsynk Python Library

PyPI version codecov

The Python library is available through pip: pip install sunsynk