Energy

Sigenergy ESS

TypQxQ/Sigenergy-Local-Modbus · vv.1.2.7.5

HACSLocal polling

Sigenergy Energy Storage System Integration for local Modbus‑TCP monitoring and control into Home Assistant. Gain real‑time insights, dynamic device management, and seamless UI‑based setup.

Documentation Source code

In Apple Home through HomeKit Bridge

What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.

Entity	Shows up as	Note
`switch`	Switch or outlet
`binary_sensor`	Sensor (motion, contact, leak, smoke…)
`sensor`	Sensor (temperature, humidity, air quality…)
`button`	Button (as a switch)
`select`	Mode picker (as switches)

What people report

Local Modbus access to Sigenergy ESS plants works, with write controls off by default. PSS/PID enterprise devices are excluded and grid-side info is limited.

Works3
Won’t be supported1

Device	In Home Assistant	What they said	Source
Sigenergy AC charger	Works Local	Normally device ID 1; inverters need another ID Saved copy … added in Modbus Protocol v2.9 (released 2026-05-13) is intentionally excluded because they are commercial enterprise devices and we cannot test them. Sigenergy "Grid side info" is not fully available over local Modbus. The grid-side details shown in the Sigen app are not currently exposed through a stable Modbus register set. The grid phase voltage/current sensors that were added in v1.2.2 have been removed in this version because they are no longer supported or … Register validation failed ... exceptioncode=2 usually means an unsupported register. If you see this in debug logs, the … Excerpt saved from the README on 2026-10-23.	README
Sigenergy DC charger	Works Local	Start/stop controls restored in v1.2.7.1 Saved copy Summary - keep the write-only DC charger start/stop controls independent of optional running-state register `31513` - keep the deprecated DC charging switch available and `off` for a valid Idle state - when `31513` is unavailable, use other responding DC telemetry for command availability and use output power as the deprecated switch's legacy state fallback - restore DC controls that v1.2.7 previously marked `hidden_by=integration` - bump the integration version to `1.2.7.1` ## Root cause PR #398 in v1.2.7 added `register_support_keys=("dc_charger_running_state",)` to the deprecated DC switch … Excerpt saved from GitHub on 2026-10-23.	PR #404 · 2026-08
Sigenergy SigenStor ESS	Works Local	Modbus over LAN works; only one network connection may be accepted at a time Saved copy Hello, I've been using this integration for a while now, with my sigenstor connected through wifi. I plugged in a lan cable to sigenstor recently and from the sigen app it shows it's using the lan connection now. I tried setting up a new plant in HA, entering the sigenstor's lan ip but it doesn't seem to be able to communicate with the battery. I've also tried removing the existing integration containing the connection using the wireless ip and going through the setup process for the new lan ip but it still wasn't able to communicate. I can ping both the lan and wireless ip, both ips are … Excerpt saved from GitHub on 2026-10-23.	Discussion #254 · 2025-11
Sigenergy PSS and PID devices	Won’t be supported Local	Excluded; commercial enterprise devices that cannot be tested Saved copy Limitations: Modbus Protocol v2.9 Support & PSS/PID Exclusion: Support for PSS (Packaged Substation System) and PID (Potential Induced Degradation) devices added in Modbus Protocol v2.9 (released 2026-05-13) is intentionally excluded because they are commercial enterprise devices and we cannot test them. Sigenergy "Grid side info" is not fully available over local Modbus. The grid-side details shown in the Sigen app are not currently exposed through a stable Modbus register set. The grid phase voltage/current sensors that were added in v1.2.2 have been removed in this version because they are … Excerpt saved from the README on 2026-10-23.	README

Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.

How it connects

Local polling

Talks to the device on your network, asking it for updates every so often.

Found automatically over

DHCP

Details

Installs (analytics)	2,656 (0.37%)
GitHub stars	310
Latest version	v.1.2.7.5 (2026-10-18)
Set up in the UI	Yes
Maintainers	@TypQxQ
License	MIT

Limitations from the README

Modbus Protocol v2.9 Support & PSS/PID Exclusion: Support for PSS (Packaged Substation System) and PID (Potential Induced Degradation) devices added in Modbus Protocol v2.9 (released 2026-05-13) is intentionally excluded because they are commercial enterprise devices and we cannot test them.
Sigenergy "Grid side info" is not fully available over local Modbus. The grid-side details shown in the Sigen app are not currently exposed through a stable Modbus register set. The grid phase voltage/current sensors that were added in v1.2.2 have been removed in this version because they are no longer supported or …
Register validation failed ... exceptioncode=2 usually means an unsupported register. If you see this in debug logs, the integration is likely skipping registers your device does not expose, not failing the whole integration. Address 30281 is Merged Alarm7 in the 2025-11-28 V2.8 document and may be unsupported if your …
Controls and diagnostic entities are conservative by default. Write controls and many diagnostic sensors are disabled by default. To use controls, disable read-only mode in the integration options and enable the specific entity in Home Assistant only if you understand the setting.
Device IDs and topology matter. AC chargers are normally device ID 1; inverters must use another ID. DC charger data is read via the inverter, and all devices in a plant should normally use the same host and port.

In ReReHome

Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.

Bridges get their own settings page listing the accessories behind them.

Sources

Documentation: https://github.com/TypQxQ/Sigenergy-Local-Modbus
Source code: https://github.com/TypQxQ/Sigenergy-Local-Modbus
Issues: https://github.com/TypQxQ/Sigenergy-Local-Modbus/issues
HACS: https://hacs.xyz