Monitor and control your Sigenergy Energy Storage System (ESS) from Home Assistant.

• UI‑Driven Setup with DHCP discovery of inverters and chargers
• Dynamic Device Management (Plants, Inverters, AC/DC Chargers)
• Real‑Time Metrics for power flows, energy statistics, SoC/SoH
• Control Capabilities for EMS work modes and more
• Configurable update interval in three update frequencies for faster updates

• Home Assistant
• Home Assistant Community Store (HACS)
• Sigenergy ESS with Modbus‑TCP enabled by your installer. And prefferably confirmed with a screenshot of your DeviceID. If using AC Charger, that will have the id 1 and the inverter has to be set to a higher ID, for example 2.
• Prefferably assign a static IP to your Sigenergy device in your router to ensure it always receives the same IP address.

1. Go to HACS > Integrations in Home Assistant
2. Search and install Sigenergy ESS Integration
3. Restart Home Assistant

1. Download the latest .zip from the Releases page
2. Extract and copy custom_components/sigen into your HA custom_components/ folder
3. Restart Home Assistant

Central Plant entry groups devices by Host/IP and Port where the Port is by default 502 and the IP is the one of the first Inverter.

Plant (IP:Port) ├─ Inverter 1 (ID 2) │ └─ DC Charger (via Inverter 2) ├─ Inverter 2 (ID 3) └─ AC Charger (ID 1) ** Is 1 by default and very hard to change ** 

1. Navigate to Settings > Devices & Services
2. If your Sigenergy device is discovered automatically on the network, it will appear under Discovered.
   If not discovered, try unplugging and replugging the network cable of your Sigenergy system.
   If discovery still fails, see the Troubleshooting section below.

Controls are read-only by default. To enable control features, you must explicitly activate them in the integration configuration and allow them in Home Assistant. This precaution helps prevent unintended changes or adverse effects.

1. Navigate to Settings > Devices & Services > Add Integration
2. Search for Sigenergy
3. If discovered, click Configure; otherwise select manually
4. Enter Host IP, Port (default 502), and first Device ID
5. Add additional Inverters/Chargers via the same Plant entry

1. Navigate to Settings > Devices & Services.
2. Find your Sigenergy integration entry and click Configure.
3. From the configuration menu, you can:
   • Adjust Plant settings (e.g., read-only, refresh intervals).
   • Modify settings for individual Inverters or Chargers.

While it is technically possible to assign different IP addresses and ports to devices, it is not advised. For best results and reliable operation, all devices within a plant should use the same IP address and port.

1. Navigate to Settings > Devices & Services.
2. Select the Sigenergy integration and click Add Device.
3. Follow the prompts to add extra inverters, chargers, or a new plant.

Plant Entities: active/reactive power, PV power, SoC, grid flows, EMS mode
Inverter Entities: MPPT metrics, battery SoC/SoH, phase data
AC Charger: charging power, total energy, system state
Controls: EMS work modes are exposed via select entities, and optional button/switch controls are available.

Controls are read-only by default unless explicitly enabled in the integration configuration.

alias: "Notify on Low Battery" trigger: - platform: state entity_id: sensor.plant_battery_soc to: "<20" action: - service: notify.mobile_app data: title: "Battery Low" message: "SoC dropped below 20%"

• Ensure your installer tapped SAVE after enabling Modbus‑TCP on your device.
• Verify IP and firewall settings.
• Ensure again Modbus‑TCP is enabled on your ESS.
• Check Home Assistant logs for sigen errors.

Contributions welcome!

1. Fork the repo and create a branch
2. Add tests under tests/components/sigen/
3. Follow Home Assistant coding and config‑flow patterns
4. Submit a Pull Request

• Issues: https://github.com/TypQxQ/Sigenergy-Local-Modbus/issues
• Discussions: https://github.com/TypQxQ/Sigenergy-Local-Modbus/discussions
• HACS docs: https://hacs.xyz/

MIT License © [Andrei Ignat]