Skip to main content

Library to interface Sunsynk Hybrid Inverters

Project description

Sunsynk Inverters

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.6.tar.gz (12.5 kB view details)

Uploaded Source

Built Distribution

sunsynk-0.0.6-py3-none-any.whl (8.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: sunsynk-0.0.6.tar.gz
  • Upload date:
  • Size: 12.5 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.6.tar.gz
Algorithm Hash digest
SHA256 6a6547636cfa11194e3783dfd57c7849d227763f35e9b2759e79444bfcdc6e8e
MD5 a24e6bb66510f4c7d34695eb26317c90
BLAKE2b-256 236a8ff2cf255db20ff62b0c4940d11d52e0a183c10682c239b645245f758595

See more details on using hashes here.

File details

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

File metadata

  • Download URL: sunsynk-0.0.6-py3-none-any.whl
  • Upload date:
  • Size: 8.7 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.6-py3-none-any.whl
Algorithm Hash digest
SHA256 511f4a73a1d51f3a73cbc7961ec69c94dfe1d6013c243ba0ba1f14e537536a1d
MD5 9eca8eaadc8154f226409a96e9097d33
BLAKE2b-256 74d77930a605134821403ba0ef5a35fb0d817c205e93cd2f7b2e54ce55eeaf4b

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