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

Uploaded Source

Built Distribution

sunsynk-0.0.4-py3-none-any.whl (7.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: sunsynk-0.0.4.tar.gz
  • Upload date:
  • Size: 9.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.4.tar.gz
Algorithm Hash digest
SHA256 dc9cd2f140997ada78f369cb46f1d85c331cb2bb8887c5d2e7918d8ad645b348
MD5 d17f1e3b47ede08101222e2406242f58
BLAKE2b-256 31ae422bdd3399efcd5a71a00dd1bd7531940a745eb20f693a89f951b83576c1

See more details on using hashes here.

File details

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

File metadata

  • Download URL: sunsynk-0.0.4-py3-none-any.whl
  • Upload date:
  • Size: 7.4 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.4-py3-none-any.whl
Algorithm Hash digest
SHA256 e330f9568b9696e1dec2553711c76a91384bb2388c0c685bb3b1dcfcdc221fbc
MD5 c9ebe0b3f99b29e3227eda0a9fb8a8b1
BLAKE2b-256 d4deeaae198b08e41ce1e855ef55f8f4aba189b513206a9fafd6a4a50bfff183

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