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

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

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

File metadata

  • Download URL: sunsynk-0.0.7.tar.gz
  • Upload date:
  • Size: 12.6 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.7.tar.gz
Algorithm Hash digest
SHA256 49902d823f2f2b76469b3ea4666c56099d406edecd018c19eb7b87324c1b5877
MD5 1763ce8686a35e1673458d5ca8415c42
BLAKE2b-256 f75e64e256f4f0d05e68b34b553ac38a22fd56304f42fe2109c2b6c6f8fd6825

See more details on using hashes here.

File details

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

File metadata

  • Download URL: sunsynk-0.0.7-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.7-py3-none-any.whl
Algorithm Hash digest
SHA256 b99022dc22848ac6dc7013353a4b4fbb7d1e673e109ac507dd79cb35a5a2c22a
MD5 b96373f62e970a82787b09dd88e3ec33
BLAKE2b-256 4d9812866a2fb5c54cf57a578fd7fc964dc6bd3379e7d844af29b20d1454ec0c

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