Skip to content

Dashboard

Jump to bottom
Marcin edited this page May 23, 2026 · 1 revision

Dashboard

The integration automatically creates a Lovelace dashboard when the config entry is set up. This page explains how it works, what it contains, and how to customise it.

How the auto-generated dashboard works

When the integration sets up, it:

  1. Reads the inverter alias from the API to build a human-readable dashboard title
  2. Looks up all registered entity IDs from the HA entity registry (so entity IDs are always correct, even if they differ from the expected default)
  3. Creates or updates a Lovelace storage dashboard at a fixed URL path tied to your config entry
  4. Registers it in the HA sidebar under "Solar {alias}"

The dashboard is regenerated every time the integration is reloaded. If you make manual changes to the dashboard through the UI, they will be overwritten on next reload. See Customisation below for how to work around this.

Views

Overview

The main view. Uses type: panel for a full-width layout. Contains (top to bottom):

Sunsynk Power Flow Card — live animated power flow diagram showing:

  • PV generation and MPPT string breakdown
  • Battery state, SOC and direction
  • Grid import/export
  • Load consumption
  • Daily energy totals for each flow

Quick Stats — horizontal stack of four cards:

  • Battery gauge (colour-coded: green >60%, yellow >30%, red below)
  • Solar PV: power now, today and total
  • Battery: SOC, power, voltage, current, temperature
  • Grid: power, frequency, import/export today

Solar Forecast (only shown if forecast is configured):

  • Two tile cards showing today's and tomorrow's predicted kWh yield
  • Weather conditions glance: cloud cover, precipitation, GHI, DNI

Today's Energy — six-entity glance card:

  • PV generated, load consumed, battery charged, battery discharged, grid import, grid export

Charts

Standard HA built-in chart cards:

  • Power history (24 h) — solar, battery, grid, load
  • Battery SOC (48 h)
  • Daily PV generation (last 30 days, bar chart)
  • Daily energy balance (last 14 days, bar chart) — import, charge, discharge, load
  • Temperatures (24 h) — battery, DC, AC/IGBT

Settings

All writable entities grouped logically:

  • System Mode — work mode, energy mode, sell/export limits, zero export
  • Battery Settings — shutdown/restart/low capacity, charge/discharge current limits
  • Time Slots — 6 slots with start time, capacity target, sell power limit and enable switch
  • Active Days — enable/disable sell schedule per day of week
  • Generator — start/on/off thresholds, charge enable, time slot enables

Diagnostics

Detailed read-only data for troubleshooting:

  • Inverter info (firmware versions, serial, brand, model, status)
  • Grid details (reactive power, power factor, totals)
  • Battery details (BMS data, limits, voltages)
  • All-time totals

Sunsynk Power Flow Card

The Power Flow Card is bundled with this integration — you do not need to install it separately from HACS. It is served at /sunsynk/sunsynk-power-flow-card.js and registered as a frontend resource automatically on startup.

The card version bundled is v7.3.3 by slipx06. See the original project for full documentation on all card options.

Customisation

Because the auto-generated dashboard is overwritten on each reload, the recommended approach for customisation is to create a separate dashboard and copy the cards you want to modify.

Option A — Create a personal copy (recommended)

  1. Open the auto-generated Solar dashboard
  2. Click Edit Dashboard (pencil icon) → three-dot menu → Raw Configuration Editor
  3. Select all and copy the YAML
  4. Go to Settings → Dashboards → Add Dashboard — give it a custom name
  5. Open it → Edit → Raw Configuration Editor → paste the copied YAML
  6. Edit freely — this copy is not managed by the integration

Option B — Use the YAML template

The repository includes a dashboard template at dashboards/sunsynk-dashboard.yaml. This is the same layout but uses the INVERTER placeholder instead of real entity IDs.

  1. Download the file from the repository
  2. Open it in a text editor and replace every occurrence of INVERTER with your entity prefix (e.g. my_sunsynk)
  3. Import into a new HA dashboard via Raw Configuration Editor

Option C — Disable auto-dashboard

If you don't want the integration to manage a dashboard at all, you can remove the auto-generated one and ignore it. The integration will try to create/update it on each reload but failures are logged as warnings and do not affect sensor functionality.

Energy Dashboard integration

To add your inverter data to the HA Energy Dashboard (Settings → Energy):

Category Entity
Solar production sensor.{prefix}_pv_generation_today
Grid consumption sensor.{prefix}_grid_import_today
Return to grid sensor.{prefix}_grid_export_today
Battery charging sensor.{prefix}_battery_charge_today
Battery discharging sensor.{prefix}_battery_discharge_today

These sensors use state_class: total_increasing which HA requires for the energy dashboard.

Clone this wiki locally