Skip to main content

Library to interface Sunsynk Hybrid Inverters

Project description

Sunsynk Inverters *beta*

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

See https://www.sunsynk.org/ for more information on Sunsynk inverters.

This code was developed on a Sunsynk 5.5 kWh

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

Sunsynk Python Library

codecov

The Python library is available through pip:

pip install 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. Below an example of the HomeAssistant Energy management dashboard using sensors from the Sunsynk.

HASS Energy management

Add-On Installation

  1. Add the repository to your 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

Tested Inverters

There are several inverters that are rebranded Deye inverters, so you might have success with other inverter brands as well, please add your inverter by editing tis file and creating a Pull Request if you have success

Inverter Model Battery Version User
Sunsynk 5.5kW Hubble AM-2 beta/all @kellerza

Hardware

I used a RS485 adaptor sourced from Banggood, very similar to this

Mine is wired to the Sunsynk BMS 485 port (top left). I also have a RS485 port (bottom right) but this did not work.

The wiring and Ethernet color code to an RJ-45 plug crimped according to TI-568A. RJ45 requires a twisted pair, but you can use either TI-568A or TI-568B

RJ45 Pin RS485 adaptor Color (568A)
1 B/D- Green-White
2 A/D+ Green

Credits

Information in the Power forum was especially helpful to get this up and running, see this thread

Special Kudos to Bloubul7, @jacauc and Sc00bs

The original Node-RED flows can be found on @jacauc's repo here

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

sunsynk-0.0.3.tar.gz (8.9 kB view details)

Uploaded Source

Built Distribution

sunsynk-0.0.3-py3-none-any.whl (7.1 kB view details)

Uploaded Python 3

File details

Details for the file sunsynk-0.0.3.tar.gz.

File metadata

  • Download URL: sunsynk-0.0.3.tar.gz
  • Upload date:
  • Size: 8.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.7

File hashes

Hashes for sunsynk-0.0.3.tar.gz
Algorithm Hash digest
SHA256 f7e04bbbe7f770e1a75067ff60af4cbaf4714a231a07f0430a166d46a17ffc20
MD5 4199df83acb6c3620bdf7546022a4855
BLAKE2b-256 b8b459f6d0bb9be219c617d70413615e7d3442b8f0bc75e241f0bbc606306093

See more details on using hashes here.

File details

Details for the file sunsynk-0.0.3-py3-none-any.whl.

File metadata

  • Download URL: sunsynk-0.0.3-py3-none-any.whl
  • Upload date:
  • Size: 7.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.7

File hashes

Hashes for sunsynk-0.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 19bf6e9ab94994a3dc4c96a3c201f3b46e3d84131b7041bd8cfaa1158ec940b5
MD5 c3c7a66aaca16b2444607dbc9817a243
BLAKE2b-256 89dc1e828b013f2f28ffcb7088b1cf0a161f6aadcada5072f8c8f9cef083df22

See more details on using hashes here.

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