Repository navigation
SolarEdge Control Recovery
SolarEdge battery setup · AC inverter curtailment
PowerSync stops SolarEdge control writes when an entity service call may have reached the inverter but its result cannot be confirmed. A failed call does not establish that the inverter rejected the command or returned to normal operation. PowerSync preserves the prior baseline and records the uncertain write. It does not attempt rollback, zero the charge or discharge limits, or retry the command.
The control block survives Home Assistant restart. Startup does not replay persisted SolarEdge force commands or expiry timers.
The control block also covers a completed dispatch if Home Assistant restarts while PowerSync still owns the settings. During supervised recovery, a fresh readback can confirm the owned settings or the original baseline. Monitoring remains available while writes are blocked.
The Battery Integration Details sensor exposes control_health, control_mutation_active, and last_control_mutation. A value of reconciliation_required means that further control requests remain blocked. This state does not say that battery power is zero or that the last command stopped.
An automatic curtailment or restore request rejected because its permission was disabled before the inverter call records outcome: rejected and possibly_transmitted: false. It leaves control ready and does not require reconciliation. This also covers permission changing while PowerSync saves its control journal. A failed or uncertain inverter call still blocks further control, and upgrading does not clear an existing reconciliation block.
Inspect the inverter and its upstream SolarEdge Modbus Multi connection. Establish safe storage settings using the inverter's supported controls under supervision. Keep automatic dispatch disabled during this inspection.
Open Developer Tools > Template and run the following template to find the PowerSync entry ID.
{{ config_entry_id('sensor.power_sync_battery_integration_details') }}Use your actual Battery Integration Details entity ID if it has been renamed or has a suffix. Copy the ID into the entry_id field when calling the recovery action.
action: power_sync.reconcile_solaredge_control
data:
entry_id: YOUR_POWERSYNC_ENTRY_ID
acknowledge: trueThis service reads storage settings through a fresh update of the existing upstream integration. It clears the block only when it identifies the correct inverter, obtains fresh readback, and validates a benign storage baseline. Cached Home Assistant entity values, elapsed time, and a restart are insufficient. Unsupported upstream readback or an unsafe baseline leaves the block in place.
The service can restore a completed dispatch only when fresh readback confirms its owned settings and every prior write was confirmed. The response then reports released_owned_dispatch. Otherwise every saved field must already match the baseline and the service writes nothing.
A successful reconciliation clears the retained transaction and allows the next command to capture its baseline. Review the control-health attributes before resuming automatic dispatch. Reconciliation does not restore an earlier force command or timer.
Storage readback cannot validate an uncertain active-power curtailment write. The reconciliation service leaves that block in place; recovery requires separate validation of the active-power controls.
Restoring SolarEdge active-power curtailment requires a fresh readback of the 100% limit. A successful write acknowledgement alone no longer clears PowerSync's existing curtailment state. PowerSync briefly checks for delayed application without repeating the write during that check.
For a separately configured SolarEdge AC inverter, an unconfirmed restore retains an existing curtailment state for the normal restore checks. For SolarEdge battery control, an uncertain transaction retains its saved obligation and can require supervised recovery as described above.
A confirmed 100% limit establishes that the output cap was released. It does not prove solar generation: night, insufficient sunlight, inverter protection or another controller can still affect output.
Connect your system
- Battery directory
- Connection methods and sensors
- Electricity providers
- Tariffs and time periods
- Amber Smart Shift
Manage energy
- Smart Optimization
- Optimization settings
- HA optimiser access
- EV charging
- EV load management
- Advanced settings
- Controls and automations
Readings and controls
Help