Home

SunSpec Modbus for Home Assistant

The README gets the integration installed and answers the questions most people have. Two pages in the repository go deeper where that is needed:

• Troubleshooting in detail: the plausibility filter, the inverter that vanishes at night, what the log lines mean, which diagnostics field answers which question
• Battery and export control: every write entity with the register behind it, the revert timer, and what is deliberately not writable

This wiki holds what fits in neither place: things to build on top of the sensors, and how the integration works underneath.

Recipes

Copy-and-adapt material. Every page starts with the entities it needs.

• Energy dashboard and statistics: grid import and export from a SunSpec meter, battery energy without a counter, daily and monthly totals, self-consumption
• Zero export and export limiting: a fixed cap, the keepalive pattern the revert timer wants, a control loop against a grid meter, curtailment at negative prices
• Battery control: charge in cheap hours, cap the overnight discharge, keep a reserve
• Alerts and notifications: faults, a silent inverter on a sunny day, the daily summary
• Dashboard cards: cards that work with what the integration exposes
• n8n workflows: the same controls driven from n8n, and events pushed from Home Assistant into n8n
• Node-RED workflows: the same controls from Node-RED, and inverter events read straight off the websocket
• Sharing the inverter with other programs: a Modbus proxy in front of a single-slot inverter

Reference

• SunSpec models explained: what the block numbers mean and which ones are polled by default
• Entity names and IDs: how device and entity names are put together, and how to find the id you need
• Diagnostics file reference: the download, field by field
• Vendor notes: how to switch Modbus TCP on per brand, ports, unit IDs, quirks
• Hardware reports: which devices have been seen working, and with which firmware
• FAQ

Under the hood

• How polling works in depth: the held session, the gateway lock, the layout cache, the error categories
• Contributing and development

Corrections

The vendor notes and hardware reports live from what people send in. If a page is wrong for your device, open an issue with the page name and what you saw, or edit the page directly if your account can.