Skip to content

V1.5.0

Choose a tag to compare

@hcraveiro hcraveiro released this 04 May 08:10
d5a39fd

What's changed

This release brings a major internal refactor of the API layer and improves compatibility with the current EU5 FusionSolar web login flow.

Internal API refactor

The previous monolithic API implementation has been split into a modular package structure with dedicated mixins for:

  • authentication
  • station handling
  • battery data
  • inverter data
  • social contribution
  • energy balance
  • installation flow parsing

This refactor does not change the public behavior of the integration, but it makes the codebase much easier to maintain and prepares it for future expansion, such as additional device domains.

Installation flow restructuring

The installation-level logic was separated from the main API class into a dedicated installation domain. This includes:

  • realtime flow retrieval
  • flow node and link parsing
  • device DN discovery
  • installation-level sensor output building
  • installation device creation

The result is a much smaller and clearer main API class.

Inverter domain cleanup

Inverter-specific discovery and metadata loading were moved into the inverter domain, improving separation of responsibilities and keeping inverter logic grouped together.

Improved EU5 login compatibility

The EU5 login flow has been updated to better match the current FusionSolar browser login process.

This includes:

  • support for service-aware login URLs
  • service-aware validateUser requests
  • preserved fallback to the legacy login flow for backwards compatibility

This should improve compatibility for users whose credentials work on the FusionSolar website but previously failed in Home Assistant with:
Login response did not include redirect information
or
errorCode=406

Notes

  • Existing entity names and unique IDs are preserved
  • Existing coordinator behavior is unchanged
  • Existing working installations should continue to work thanks to the legacy fallback path