-
-
Notifications
You must be signed in to change notification settings - Fork 16
Sensors
PowerSync automatically creates sensor entities for energy monitoring. The sensors available depend on your battery system and whether Smart Optimization is enabled.
All battery systems get these real-time power sensors:
| Sensor | Entity ID | Unit | Description |
|---|---|---|---|
| Solar Power | sensor.power_sync_solar_power |
kW | Total solar generation |
| Grid Power | sensor.power_sync_grid_power |
kW | Grid import (+) / export (-) |
| Battery Power | sensor.power_sync_battery_power |
kW | Charge (+) / discharge (-) |
| Home Load | sensor.power_sync_home_load |
kW | Home consumption |
| Battery Level | sensor.power_sync_battery_level |
% | State of charge |
| Battery Max Charge Power | sensor.power_sync_battery_max_charge_power |
kW | BMS or configured maximum charge power used by force modes and app sliders |
| Battery Max Discharge Power | sensor.power_sync_battery_max_discharge_power |
kW | BMS or configured maximum discharge power used by force modes and app sliders |
| Battery Mode | sensor.power_sync_battery_mode |
— | Current PowerSync mode: normal, force charge, force discharge, hold SOC, or self-consumption |
PowerSync creates price sensors based on your electricity provider.
| Sensor | Entity ID | Unit | Description |
|---|---|---|---|
| Current Import Price | sensor.power_sync_current_import_price |
$/kWh | Current grid import price after provider-specific adjustments |
| Current Export Price | sensor.power_sync_current_export_price |
$/kWh | Current feed-in/export value |
| TOU Schedule | sensor.power_sync_tariff_schedule |
— | Current tariff schedule used for display, static TOU providers, EV planning, and Smart Optimization. Tesla sites can upload this schedule to the Powerwall; Modbus systems such as NeoVolta use it inside PowerSync only |
| AEMO Price | sensor.power_sync_aemo_price |
$/MWh | Current AEMO dispatch price when AEMO spike detection is configured |
| AEMO Spike Status | sensor.power_sync_aemo_spike_status |
— | Spike detector state and current threshold status |
Created for Flow Power users.
| Sensor | Entity ID | Unit | Description |
|---|---|---|---|
| Flow Power Import Price | sensor.power_sync_flow_power_price |
$/kWh | Import rate after PEA adjustment |
| Flow Power Export Price | sensor.power_sync_flow_power_export_price |
$/kWh | Happy Hour export rate or 0 |
| Flow Power TWAP 30-Day Average | sensor.power_sync_flow_power_twap |
c/kWh | Rolling 30-day wholesale average |
| Flow Power Network Tariff | sensor.power_sync_flow_power_network_tariff |
c/kWh | Current network tariff rate when configured |
| Flow Power Amber Comparison | sensor.power_sync_flow_power_amber_comparison |
$/kWh | Equivalent Amber-style rate for comparison |
When the optional Flow Power portal connection is configured, extra account sensors are also created for actual PEA, BPEA, CPEA, LWAP, TWAP, DLF, and demand values.
Created when Octopus Saving Sessions are enabled.
| Sensor | Entity ID | Description |
|---|---|---|
| Saving Session Active | sensor.power_sync_saving_session_active |
Whether a saving session is currently active |
| Next Saving Session | sensor.power_sync_next_saving_session |
Next known saving session window |
| Saving Session Rate | sensor.power_sync_saving_session_rate |
Reward rate converted from Octopoints when available |
Accumulated energy totals that reset at local midnight. Available for all battery systems:
| Sensor | Entity ID | Unit | Description |
|---|---|---|---|
| Daily Solar Energy | sensor.power_sync_daily_solar_energy |
kWh | Solar generation today |
| Daily Grid Import | sensor.power_sync_daily_grid_import |
kWh | Energy imported from grid today |
| Daily Grid Export | sensor.power_sync_daily_grid_export |
kWh | Energy exported to grid today |
| Daily Battery Charge | sensor.power_sync_daily_battery_charge |
kWh | Battery charge energy today |
| Daily Battery Discharge | sensor.power_sync_daily_battery_discharge |
kWh | Battery discharge energy today |
| Daily Home Consumption | sensor.power_sync_daily_load |
kWh | Home energy consumption today |
All daily energy sensors are compatible with the Home Assistant Energy Dashboard.
PowerSync calculates daily and month-to-date costs from the live price feed and measured energy.
| Sensor | Entity ID | Unit | Description |
|---|---|---|---|
| Daily Import Cost | sensor.power_sync_daily_import_cost |
currency | Cost of grid imports today |
| Daily Export Earnings | sensor.power_sync_daily_export_earnings |
currency | Export earnings today |
| Daily Average Cost per kWh | sensor.power_sync_daily_avg_cost_per_kwh |
currency/kWh | Net daily average energy cost |
| Month-to-Date Average Cost per kWh | sensor.power_sync_mtd_avg_cost_per_kwh |
currency/kWh | Month-to-date net average energy cost |
For Amber users with usage tracking enabled, PowerSync also creates metered bill sensors from Amber usage data:
| Sensor | Entity ID | Unit | Description |
|---|---|---|---|
| Yesterday Billed Cost | sensor.power_sync_amber_usage_yesterday_cost |
currency | Actual metered cost for yesterday |
| Yesterday Battery Savings | sensor.power_sync_amber_usage_yesterday_savings |
currency | Estimated savings attributable to battery behavior yesterday |
| Month To Date Billed Cost | sensor.power_sync_amber_usage_month_cost |
currency | Actual metered month-to-date cost |
| Month To Date Battery Savings | sensor.power_sync_amber_usage_month_savings |
currency | Estimated month-to-date battery savings |
Created automatically when EV charging is configured. These sensors feed into the power flow card and power flow visualizations.
| Sensor | Entity ID | Unit | Description |
|---|---|---|---|
| EV Power | sensor.power_sync_ev_power |
kW | Current EV charging power |
| EV Battery Level | sensor.power_sync_ev_battery_level |
% | EV battery state of charge |
Created automatically for systems that report individual solar string data.
| Sensor | Entity ID | Unit | Description |
|---|---|---|---|
| PV DC Power | sensor.power_sync_pv_dc_power |
kW | DC-coupled solar array power |
| PV AC Power | sensor.power_sync_pv_ac_power |
kW | AC-coupled solar inverter power |
See FoxESS Sensors below for PV1/PV2 string sensors.
FoxESS users get additional sensors from data PowerSync already reads from the inverter. These replace the need for a separate integration:
| Sensor | Entity ID | Unit | Description |
|---|---|---|---|
| PV1 Power | sensor.power_sync_pv1_power |
kW | DC string 1 power |
| PV2 Power | sensor.power_sync_pv2_power |
kW | DC string 2 power |
| CT2 Power | sensor.power_sync_ct2_power |
kW | AC-coupled inverter power (e.g. Solis behind FoxESS) |
| Inverter Work Mode | sensor.power_sync_work_mode |
— | Self Use / Feed-in / Backup |
| Minimum SOC | sensor.power_sync_min_soc |
% | Backup reserve setting |
| Daily Battery Charge | sensor.power_sync_daily_battery_charge_foxess |
kWh | Today's charge energy |
| Daily Battery Discharge | sensor.power_sync_daily_battery_discharge_foxess |
kWh | Today's discharge energy |
ESY Sunhome users get three additional sensors sourced from the BMS and inverter:
| Sensor | Entity ID | Unit | Description |
|---|---|---|---|
| Inverter Temperature | sensor.power_sync_esy_inverter_temperature |
°C | Inverter heat sink temperature |
| Battery Status | sensor.power_sync_esy_battery_status |
— | Operating state text from firmware (e.g. "Charging") |
| Battery Health (SOH) | sensor.power_sync_esy_battery_soh |
% | State of health reported by the BMS |
Available for all battery systems:
| Sensor | Entity ID | Unit | Description |
|---|---|---|---|
| Battery Health | sensor.power_sync_battery_health |
% | Battery state of health |
How it works by system:
| System | Source | Setup Required |
|---|---|---|
| Sungrow | Read automatically from inverter | None — works out of the box |
| Sigenergy | Read automatically from inverter | None — works out of the box |
| GoodWe | Read automatically from inverter | None — works out of the box |
| AlphaESS | Read automatically from inverter | None — works out of the box |
| ESY Sunhome | Read from BMS via ESY Sunhome integration | None — works out of the box |
| FoxESS H3 Smart | Read automatically from inverter | None — works out of the box |
| Tesla | TEDAPI scan via mobile app, or capacity sensor blueprint | See Dashboard Setup |
| FoxESS (H1/H3/H3-Pro/KH) | Not available | Shows "Unknown" |
| Solax Hybrid | Not available | Shows "Unknown" |
| SAJ H2 / HS2 | Not available | Shows "Unknown" |
| Neovolt / Bytewatt | Read from Neovolt integration when exposed | None if the upstream entity exists |
Tesla Powerwall users may receive additional cloud energy-history sensors and local TEDAPI sensors.
| Sensor | Entity ID | Description |
|---|---|---|
| Firmware | sensor.power_sync_firmware |
Gateway or system firmware version |
| Lifetime Solar Energy | sensor.power_sync_lifetime_solar_energy |
Lifetime solar generation |
| Lifetime Grid Import | sensor.power_sync_lifetime_grid_import |
Lifetime grid imports |
| Lifetime Grid Export | sensor.power_sync_lifetime_grid_export |
Lifetime grid exports |
| Lifetime Battery Charged | sensor.power_sync_lifetime_battery_charged |
Lifetime battery charge energy |
| Lifetime Battery Discharged | sensor.power_sync_lifetime_battery_discharged |
Lifetime battery discharge energy |
| Lifetime Home Consumption | sensor.power_sync_lifetime_home_consumption |
Lifetime site load |
| Backup Time Remaining | sensor.power_sync_backup_time_remaining |
Estimated backup runtime |
| Total Pack Energy | sensor.power_sync_total_pack_energy |
Total energy stored across packs |
| Energy Left | sensor.power_sync_energy_left |
Estimated stored energy remaining |
| Grid Services Power | sensor.power_sync_grid_services_power |
Current grid-services dispatch power when applicable |
Created after Powerwall local pairing is completed.
| Sensor | Entity ID Pattern | Description |
|---|---|---|
| System Island State | sensor.power_sync_pw_system_island_state |
Local grid/island status |
| Powerwall Count | sensor.power_sync_pw_count |
Number of detected Powerwall blocks |
| Active Alerts | sensor.power_sync_pw_active_alerts |
Count and attributes for local gateway alerts |
| Per-pack SOC |
sensor.powerwall_1_soc, sensor.powerwall_2_soc, ... |
State of charge by Powerwall pack |
| Per-pack Capacity |
sensor.powerwall_1_capacity, ... |
Energy capacity by pack |
| Per-pack Voltage |
sensor.powerwall_1_voltage, ... |
Pack voltage |
| Per-pack Temperature |
sensor.powerwall_1_temperature, ... |
Pack temperature |
| Per-pack SOH |
sensor.powerwall_1_soh, ... |
State of health by pack |
| Sensor | Entity ID | Description |
|---|---|---|
| DC Solar Curtailment | sensor.power_sync_solar_curtailment |
Current DC curtailment state and reason |
| Inverter Status | sensor.power_sync_inverter_status |
AC-coupled inverter curtailment state and last action |
When Smart Optimization is enabled, these sensors are created for all battery systems:
| Sensor | Entity ID | Description |
|---|---|---|
| Optimizer Current Action | sensor.power_sync_optimization_status |
Current action: idle, charge, discharge, export, self_consumption. Attributes: power_w, status
|
| Optimizer Next Action | sensor.power_sync_optimization_next_action |
Next scheduled action. Attributes: time (ISO timestamp), power_w
|
| Optimizer Force Charge Windows | sensor.power_sync_optimization_force_charge_windows |
Upcoming LP-planned grid charge windows as compact time ranges (e.g. 02:30-04:15). Attributes: count, total_minutes, windows (list with start_time, end_time, power_w, soc per window) |
When the LP optimizer is running, PowerSync also creates forecast sensors:
| Sensor | Entity ID | Unit | Key Attributes |
|---|---|---|---|
| Solar Forecast | sensor.power_sync_lp_solar_forecast |
kWh |
peak_kw, forecast_values_kw
|
| Load Forecast | sensor.power_sync_lp_load_forecast |
kWh |
peak_kw, forecast_values_kw
|
| Import Price Forecast | sensor.power_sync_lp_import_price_forecast |
$/kWh |
min_price, max_price, price_values
|
| Export Price Forecast | sensor.power_sync_lp_export_price_forecast |
$/kWh |
min_price, max_price, price_values
|
| Load Forecast Today Remaining | sensor.power_sync_load_forecast_today_remaining |
kWh | Away Mode recovery attributes when active |
| Load Forecast Tomorrow | sensor.power_sync_load_forecast_tomorrow |
kWh | hourly_forecast |
Note: Price forecast sensors are most useful for dynamic pricing providers (Amber, Octopus Agile/Flux, AEMO, Flow Power, Localvolts, EPEX). Fixed-price providers still use known tariff periods for optimization.