sigenergy2mqtt 2025.12.29

Publish Modbus data from Sigenergy to MQTT, with optional Home Assistant Auto-Discovery and PVOutput updating

sigenergy2mqtt is a bridge between the Modbus interface of the Sigenergy energy system and the MQTT lightweight publish/subscribe messaging protocol.

In addition, sigenergy2mqtt has several optional features:

1. It can publish the appropriate messages to allow Home Assistant to automatically discover the Sigenergy devices, simplifying Home Assistant configuration.
2. Production and consumption data can automatically be uploaded to PVOutput.
3. It can auto-discover Sigenergy devices and their device IDs without having to specify the host IP address.

Installation

Follow the installation guides for supported environments:

• Home Assistant
• Docker
• Linux

Configuration

When parsing configuration options, sigenergy2mqtt looks at the configuration sources in the following order:

1. Configuration File
2. Environment Variables^*
3. Command Line Options^*
4. Home Assistant Add-On UI

This means, for example, that the options specified in the configuration file can be overridden by environment variables and command line options.

Click on the links above to see the configuration options available.

^* Not applicable to the Home Assistant Add-On

Modbus Auto-Discovery

You can automatically discover Sigenergy devices on your network. Auto-discovery is triggered when you do not configure a Modbus host, or if you specify the command line option --modbus-auto-discovery, the environment variable SIGENERGY2MQTT_MODBUS_AUTO_DISCOVERY, or you can force it through the Home Assistant Add-on Configuration. The command line option and the environment variables take a value of either once or force: If once is specified, auto-discovery will only occur if no existing auto-discovery results are found. If force, auto-discovery will overwrite any previously discovered Modbus hosts and device IDs.

Auto-discovery is a lengthy process because your local network has to be scanned for potential Modbus hosts, and once detected there are 247 potential device IDs to be scanned on each host.

MQTT Publish and Subscribe Topics

The topics that are published and subscribed to by sigenergy2mqtt can be found here.

Disclaimer

sigenergy2mqtt was developed for my own use, and as such has only been tested in my single-phase environment without AC or DC chargers. In addition, there has been only cursory testing of the write functions. If you find a problem, please raise an issue.

Thanks

sigenergy2mqtt was inspired the Home Assistant integrations developed by TypQxQ.