Skip to content

2. How‐to‐install

Jump to bottom
Andrei Ignat edited this page Nov 6, 2024 · 4 revisions

Installation / Configuration

Overview

To integrate Sigenergy we need to do a couple of steps:

It is not and "installation" process, but more a "configuration". For this, you need to add some information to the home assistant configuration files:

Use the Visual Studio Code Server add-on for configuration. In the screenshot, the relevant files for the Sigenergy integration are highlighted: image

configuration.yaml

This is the main file of Home Assistant. In here, look for the homeassistant: row and check if there is a packages: row. In the example screenshot above it reads packages: !include_dir_named packages.

  • If you don't have that row, add it and take note of the number of spaces, like in the screenshot. Then add the folder.
  • If the packages folder is named anything else, take note of the name.

modbus_sigenergy.yaml

Download and save this file from Github to your packages folder.

secrets.yaml

  • If you don't have a secrets.yaml file, create one.
  • Add the contents of the file on GitHub to the secrets.yaml file.

Configuration in secrets.yaml

The yaml-based integration file needs 3 parameters as input. Copy the following lines in your secrets.yaml and adapt them:

sigen_modbus_host_ip: 192.168.178.xxx # TODO update with the IP of your inverter. No default. Check your router.
sigen_modbus_port: 502 # TODO update with the Modbus port of your inverter. Default is '502'
sigen_modbus_slave: 1 #TODO update with the slave address of your inverter. Default is '1'

Modbus register mapping

The file modbus_sigenergy.yaml contains the Modbus register maps, template sensors and automations to set values like the battery minimum SoC. Copy the file to a subfolder named "packages" (maybe create it first), which is located at the same level as your "configurations.yaml" (see screenshot).

Include "modbus_sigenergy.yaml" by adding the following lines to your "configuration.yaml":

homeassistant:
  packages: !include_dir_named packages

Do not forget to check your configuration (Developer Tools --> hit "check configuration" and restart: it won't work without a restart!)

After the restart, some new sensors should be available. E.g., check for "Sigen Plant active power"

Dashboard

  • Create a new dashboard inside Home Assistant -> Settings -> Dashboards -> Add dashboard -> From scratch.
  • Give it a name you like.
  • Go to it and edit it.
  • Press the 3 dots to the right top and chose Raw configuration editor.
  • Copy the content of the dashboard to here.
  • Save and enjoy.

Clone this wiki locally