Dashboard Setup

Dashboard Setup

A pre-built Lovelace dashboard is included for visualizing all PowerSync data.

Required HACS Frontend Cards

Install these via HACS > Frontend:

• button-card — Compact chips for controls
• card-mod — Custom card styling
• power-flow-card-plus — Real-time energy flow visualization
• apexcharts-card — Advanced charting for price/energy history

Installation

1. Install the required HACS cards listed above
2. Copy the dashboard YAML from HA Dashboard/power_sync_dashboard.yaml in the repository
3. In Home Assistant: Settings > Dashboards > Add Dashboard
4. Edit the new dashboard > three dots menu > Raw configuration editor
5. Paste the YAML content and save

Duration Selectors

The Force Charge and Force Discharge duration selectors (select.power_sync_force_charge_duration and select.power_sync_force_discharge_duration) 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 — SOH is read automatically from the inverter. No setup required, it just works.
• Tesla — Use either the mobile app TEDAPI scan or the capacity sensor blueprint below.
• FoxESS — No SOH register is available, so the sensor shows "Unknown".

See Sensors for full details.

Blueprints

Battery Health from Capacity Sensor (Tesla)

If your battery system exposes a capacity sensor (e.g. Tesla Powerwall), 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, and GoodWe users don't need this blueprint — SOH is read directly from the inverter.

Import:

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