From 7ce0fb047fd037db8f1c0a9580099d2e3c680320 Mon Sep 17 00:00:00 2001 From: Arie Catsman <120491684+catsmanac@users.noreply.github.com> Date: Tue, 21 Jan 2025 07:26:46 +0100 Subject: [PATCH] Add description of firmware version tracking for enphase_envoy. (#37022) --- source/_integrations/enphase_envoy.markdown | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/source/_integrations/enphase_envoy.markdown b/source/_integrations/enphase_envoy.markdown index 40740524122..52b9e9009e1 100644 --- a/source/_integrations/enphase_envoy.markdown +++ b/source/_integrations/enphase_envoy.markdown @@ -175,6 +175,22 @@ This integration supports updating the Envoy configuration through a `reconfigur Use this menu option also when an Envoy firmware upgrade requires a switch from local Envoy username/password to token-based authentication with Enlighten username/password (refer to [authentication requirements](#envoy-authentication-requirements)). +## Firmware updates + +The firmware version is read from the envoy when the configuration entry is loaded. The firmware version is then used in the process of determining capabilities and required authorization methods. The firmware version is available as the `sw_version` attribute of the configuration entry and shown on the device view of the envoy. + +Every 4 hours, the actual firmware version in the Envoy is compared to the known one. If the actual version differs, the configuration entry is reloaded to effect any needed configuration changes. If the moment of the firmware update is known, a manual reload on the envoy configuration entry can be done to achieve the same. + +The firmware version is not available as an entity, but rather as an attribute of the envoy. To use the firmware in automation, scripts or templates, use below example with any envoy entity. + +{% raw %} + +```yaml +{{device_attr(device_id('sensor.envoy_SN_current_power_production'),'sw_version')}} +``` + +{% endraw %} + ## Energy dashboard This integration provides several values suitable for the energy dashboard: