Skip to content

Dashboard Setup

bolagnaise edited this page May 7, 2026 · 10 revisions

Dashboard Setup

PowerSync includes an auto-generated Lovelace dashboard that adapts to your configuration. The dashboard checks which entities exist and only builds cards for features you have set up.

HACS Frontend Cards

PowerSync bundles the dashboard strategy, price charts, and animated energy-flow card. Install these via HACS > Frontend only where noted:

  • button-card — Required for compact control and status tiles
  • power-flow-card-plus — Optional fallback/additional power-flow card for custom dashboards

Optional: Tesla-Style Energy Flow (v2.6.5+)

This used to require the external tesla-style-solar-power-card HACS card. Current PowerSync releases no longer use that external card for the auto-generated dashboard.

PowerSync now registers its own built-in custom:power-sync-energy-flow card and uses it automatically for the dashboard power-flow scene, with full entity mapping including:

  • Core sensors (solar, grid, battery, home load)
  • EV charging power (when EV is configured)
  • Individual PV arrays (when available)
  • Weather entity for dynamic backgrounds
  • Sun entity for day/night theming

You do not need to install tesla-style-solar-power-card for the PowerSync dashboard. power-flow-card-plus remains optional for custom dashboards and as a legacy fallback path.

Installation

The dashboard is auto-created when PowerSync loads. It appears in your sidebar as PowerSync.

No manual YAML configuration is required. All cards are built dynamically based on your configured entities.

If you don't see it:

  1. Ensure button-card is installed
  2. Restart Home Assistant
  3. Check Settings > Dashboards — "PowerSync" should appear

Built-In PowerSync Panel

The integration also registers a built-in PowerSync panel served from the integration frontend. It provides PowerSync-native views for live status, controls, optimizer settings, tariff/price charts, EV charging, and the animated energy-flow scene. The panel uses the same entities and HTTP endpoints as the mobile app, so sections appear only when the matching feature is configured.

For the energy-flow scene, optional weather and PV string entities are auto-detected where possible. Tesla local pairing adds off-grid controls and Powerwall block health details when available.

Dashboard Sections

The dashboard includes feature sections that are shown only when the relevant entities exist:

Section When It Appears
Price Gauges Price sensors exist
Battery Controls Battery system configured
Smart Optimizer Optimizer enabled
Power Flow Core power sensors
Price Chart Dynamic pricing provider
TOU Schedule TOU tariff synced
LP Forecast Summary Smart Optimizer active
LP Solar/Load Chart Forecast sensors exist
LP Price Chart Price forecast sensors exist
Solar Curtailment Curtailment configured
AC Inverter Controls AC inverter configured
FoxESS Sensors FoxESS battery system
Battery Health Health sensor available
Energy Charts Daily energy sensors
Demand Charge Demand tracking enabled
AEMO Spike Spike detection configured
Amber Usage Amber metered usage tracking enabled
Tesla Local Powerwall local pairing configured
EV Charging EV smart charging configured

Duration Selectors

The Force Charge and Force Discharge duration selectors are created automatically by the integration. No manual helper setup is required.

Battery Health

The Battery Health sensor (sensor.power_sync_battery_health) shows your battery's state of health as a percentage. How it gets populated depends on your battery system:

  • Sungrow, Sigenergy, GoodWe, AlphaESS, ESY Sunhome, FoxESS H3 Smart, Neovolt/Bytewatt when exposed by the upstream integration — State of health is read automatically. No setup required.
  • Tesla — Use either the mobile app TEDAPI scan or the capacity sensor blueprint below.
  • FoxESS (H1/H3/H3-Pro/KH), Solax Hybrid, SAJ H2/HS2 — Not available; the sensor shows "Unknown".

See Sensors for full details.

Blueprints

Battery Health from Capacity Sensor (Tesla)

If your Tesla Powerwall exposes a capacity sensor, you can use this blueprint to sync battery health data into PowerSync. It reads the current capacity, calculates degradation against the manufacturer spec, and calls power_sync.sync_battery_health every 6 hours.

Note: Sungrow, Sigenergy, GoodWe, AlphaESS, ESY Sunhome, and FoxESS H3 Smart users don't need this blueprint — state of health is read directly from the inverter.

Import:

Import Blueprint

Or manually: Settings > Automations & Scenes > Blueprints > Import Blueprint and paste:

https://github.com/bolagnaise/PowerSync/blob/main/blueprints/battery_health_from_powerwall_capacity_sensor.yaml

Configuration:

Setting Description Example
Capacity sensor Sensor reporting current battery capacity sensor.powerwall_capacity
Capacity sensor unit Whether the sensor reports in kWh or Wh kwh
Original capacity (Wh) Manufacturer spec total capacity 13500 (1x Powerwall), 27000 (2x)
Battery count Number of batteries (reporting only) 1

Clone this wiki locally