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

Uploaded Source

Built Distribution

sunsynk-0.0.5-py3-none-any.whl (8.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: sunsynk-0.0.5.tar.gz
  • Upload date:
  • Size: 10.4 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.5.tar.gz
Algorithm Hash digest
SHA256 04a68f9a44a103fe616c5615101e0a1325cecbed2eef1510fa1dad32257fa22b
MD5 d1310a96c75066c85ec83dee5107dc38
BLAKE2b-256 ac22b617859214ed884960bda00bcc8535f05a36513738b8ad8c04a36fd587d0

See more details on using hashes here.

File details

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

File metadata

  • Download URL: sunsynk-0.0.5-py3-none-any.whl
  • Upload date:
  • Size: 8.0 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.5-py3-none-any.whl
Algorithm Hash digest
SHA256 b55a5106a20dac56c306b5358a877ed9d9ca2a652331087fb16bf6faabc126f6
MD5 6e9858bb4b5d980177df211cf3a51414
BLAKE2b-256 f65907b83be4da7764435943eaf31f561cbb76b459627cab4eef2ec4b061494a

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