Repository navigation
Sungrow History Relink
Shown only for Sungrow under Configure > Advanced settings > Sungrow history relink. It can relink PowerSync Sungrow energy entities to matching existing mkaiser Sungrow entity IDs so the Energy Dashboard can continue using the existing long-term statistics.
Create a Home Assistant backup before applying. Open the form and read its preview/summary: only ready matches can be applied. Leave Apply ready relinks unconfirmed to inspect without applying. Confirm only after checking the proposed source/destination identities and that the existing statistics belong to the same physical site and measurement.
This is a history/entity migration, not normal telemetry discovery or a fix for incorrect historical readings. A preview with no ready matches does not authorize guessing IDs. After applying, verify the entity IDs, units/statistics continuity and Energy Dashboard before removing old integration entities.
The preview/apply HA services are documented in Services Reference. They are separate actions with the same backup/identity requirements. Do not repeatedly apply a migration merely because the dashboard has not yet refreshed.
The tables use the current form labels and help text. They list the conditional field union: a field can be hidden for a different battery, provider, route or available integration. The instructions above explain those conditions. Existing saved/discovered values take precedence over fresh fallbacks. Rate units follow the provider; check the displayed currency/energy unit.
| Field | Meaning / input | Fallback / limits |
|---|---|---|
| Apply ready relinks | Only mappings marked ready will be applied. Ambiguous, missing, and blocked mappings are skipped. | Fallback Off |