Merge pull request #6 from SourceLabOrg/spp/voltage

Add support for voltage parameter

Author: Crim

CHANGELOG.md

@@ -2,7 +2,12 @@
 The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
-## 1.1.0 (Unreleased)
+## 1.2.0 (06/05/2026)
+
+### Feature Changes
+- Add support for optional voltage sensor (v6 parameter). (Issue#5)[https://github.com/SourceLabOrg/HomeAssistant-PVOutputPublisher/issues/5]
+
+## 1.1.0 (05/20/2026)
 
 ### Feature Changes
 - Switched to strict, clock-aligned scheduling to prevent time drift and perfectly sync with PVOutput intervals. (Issue#1)[https://github.com/SourceLabOrg/HomeAssistant-PVOutputPublisher/issues/1]

README.md

@@ -62,6 +62,7 @@ This integration is installed via [HACS](https://hacs.xyz/).
    * **Secondary Solar Sensor:** (Optional) If you selected a Power (W) sensor above, select your Energy (Wh) sensor here, or vice versa, for maximum accuracy. If you only provide the primary sensor, PVOutput will automatically estimate the missing value, which may result in less accurate data. 
    * **Consumption Sensor:** (Optional) Your home's power draw or energy usage sensor.
    * **Temperature Sensor:** (Optional) Outside temperature.
+   * **Voltage Sensor:** (Optional) Tracks grid/inverter operational voltage lines.
    * **Update Frequency:** How often to push data to PVOutput (5 to 180 minutes).
 
 ### Managing Multiple Systems

custom_components/pvoutput_publisher/__init__.py

@@ -13,7 +13,7 @@
 from .const import (
     DOMAIN, CONF_API_KEY, CONF_SYSTEMS, CONF_NAME, CONF_SYSTEM_ID,
     CONF_ENTITY_ID, CONF_SECONDARY_ENTITY_ID, CONF_CONSUMPTION_ENTITY_ID,
-    CONF_TEMPERATURE_ENTITY_ID, CONF_FREQUENCY, PVOUTPUT_API_URL
+    CONF_TEMPERATURE_ENTITY_ID, CONF_FREQUENCY, PVOUTPUT_API_URL, CONF_VOLTAGE_ENTITY_ID
 )
 
 _LOGGER = logging.getLogger(__name__)
@@ -34,11 +34,12 @@ async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool:
         secondary_generation_ent_id = system.get(CONF_SECONDARY_ENTITY_ID)
         consumption_ent_id = system.get(CONF_CONSUMPTION_ENTITY_ID)
         temperature_ent_id = system.get(CONF_TEMPERATURE_ENTITY_ID)
+        voltage_ent_id = system.get(CONF_VOLTAGE_ENTITY_ID)
         frequency = int(system[CONF_FREQUENCY])
         sys_name = system.get(CONF_NAME, system_id)
 
         # We pass loop variables as default arguments to avoid Python closure late-binding bugs
-        async def push_data(now: datetime, sys_id=system_id, gen_id=generation_ent_id, sec_id=secondary_generation_ent_id, con_id=consumption_ent_id, temp_id=temperature_ent_id, name=sys_name):
+        async def push_data(now: datetime, sys_id=system_id, gen_id=generation_ent_id, sec_id=secondary_generation_ent_id, con_id=consumption_ent_id, temp_id=temperature_ent_id, volt_id=voltage_ent_id, name=sys_name):
             gen_state = hass.states.get(gen_id)
             if not gen_state or gen_state.state in ['unknown', 'unavailable']:
                 return
@@ -64,7 +65,7 @@ async def push_data(now: datetime, sys_id=system_id, gen_id=generation_ent_id, s
             has_energy_v1 = False
             has_power_v2 = False
 
-            # 1A. Primary Generation Data
+            # Primary Generation Data
             if gen_unit in ["wh", "kwh", "mwh"]:
                 raw_gen = gen_value
                 if gen_unit == "kwh":
@@ -88,7 +89,7 @@ async def push_data(now: datetime, sys_id=system_id, gen_id=generation_ent_id, s
                 log_parts.append(f"Gen1 (Power): {raw_gen} {gen_unit} -> v2={int(gen_value)}")
                 has_power_v2 = True
 
-            # 1B. Secondary Generation Data (Optional)
+            # Secondary Generation Data (Optional)
             if sec_id:
                 sec_state = hass.states.get(sec_id)
                 if sec_state and sec_state.state not in ['unknown', 'unavailable']:
@@ -127,7 +128,7 @@ async def push_data(now: datetime, sys_id=system_id, gen_id=generation_ent_id, s
                     except ValueError:
                         pass
 
-            # 2. Add Optional Consumption Data (v3 / v4)
+            # Add Optional Consumption Data (v3 / v4)
             if con_id:
                 con_state = hass.states.get(con_id)
                 if con_state and con_state.state not in ['unknown', 'unavailable']:
@@ -151,7 +152,7 @@ async def push_data(now: datetime, sys_id=system_id, gen_id=generation_ent_id, s
                     except ValueError:
                         pass
 
-            # 3. Add Optional Temperature Data (v5)
+            # Add Optional Temperature Data (v5)
             if temp_id:
                 temp_state = hass.states.get(temp_id)
                 if temp_state and temp_state.state not in ['unknown', 'unavailable']:
@@ -170,6 +171,17 @@ async def push_data(now: datetime, sys_id=system_id, gen_id=generation_ent_id, s
                     except ValueError:
                         pass
 
+            # Add Optional Voltage Data (v6)
+            if volt_id:
+                volt_state = hass.states.get(volt_id)
+                if volt_state and volt_state.state not in ['unknown', 'unavailable']:
+                    try:
+                        volt_value = float(volt_state.state)
+                        log_parts.append(f"Volt: {volt_value:.1f}V -> v6={volt_value:.1f}")
+                        payload += f"&v6={volt_value:.1f}"
+                    except ValueError:
+                        pass
+
             # --- THE HUMAN-READABLE LOG ---
             # We use INFO so it shows up without needing to enable debug logging
             _LOGGER.info("PVOutput [%s | ID: %s] Preparing to send: %s", name, sys_id, " | ".join(log_parts))

custom_components/pvoutput_publisher/config_flow.py

@@ -6,7 +6,7 @@
 from .const import (
     DOMAIN, CONF_API_KEY, CONF_SYSTEMS, CONF_NAME, CONF_SYSTEM_ID,
     CONF_ENTITY_ID, CONF_SECONDARY_ENTITY_ID, CONF_CONSUMPTION_ENTITY_ID,
-    CONF_TEMPERATURE_ENTITY_ID, CONF_FREQUENCY, DEFAULT_FREQUENCY
+    CONF_TEMPERATURE_ENTITY_ID, CONF_FREQUENCY, DEFAULT_FREQUENCY, CONF_VOLTAGE_ENTITY_ID
 )
 
 def _get_system_schema(existing_data=None):
@@ -52,6 +52,15 @@ def _get_system_schema(existing_data=None):
                 selector.EntitySelectorConfig(domain="sensor")
             )
 
+        if existing_data.get(CONF_VOLTAGE_ENTITY_ID):
+            schema[vol.Optional(CONF_VOLTAGE_ENTITY_ID, default=existing_data.get(CONF_VOLTAGE_ENTITY_ID))] = selector.EntitySelector(
+                selector.EntitySelectorConfig(domain="sensor", device_class=["voltage"])
+            )
+        else:
+            schema[vol.Optional(CONF_VOLTAGE_ENTITY_ID)] = selector.EntitySelector(
+                selector.EntitySelectorConfig(domain="sensor", device_class=["voltage"])
+            )
+
         schema[vol.Required(CONF_FREQUENCY, default=str(existing_data.get(CONF_FREQUENCY, "5")))] = vol.In(frequency_options)
 
     else:
@@ -69,6 +78,9 @@ def _get_system_schema(existing_data=None):
         schema[vol.Optional(CONF_TEMPERATURE_ENTITY_ID)] = selector.EntitySelector(
             selector.EntitySelectorConfig(domain="sensor")
         )
+        schema[vol.Optional(CONF_VOLTAGE_ENTITY_ID)] = selector.EntitySelector(
+            selector.EntitySelectorConfig(domain="sensor", device_class=["voltage"])
+        )
         schema[vol.Required(CONF_FREQUENCY, default="5")] = vol.In(frequency_options)
 
     return vol.Schema(schema)

custom_components/pvoutput_publisher/const.py

@@ -9,6 +9,7 @@
 CONF_CONSUMPTION_ENTITY_ID = "consumption_entity_id"
 CONF_TEMPERATURE_ENTITY_ID = "temperature_entity_id"
 CONF_FREQUENCY = "frequency"
+CONF_VOLTAGE_ENTITY_ID = "voltage_entity_id"
 
 DEFAULT_FREQUENCY = "5"
 PVOUTPUT_API_URL = "https://pvoutput.org/service/r2/addstatus.jsp"

custom_components/pvoutput_publisher/manifest.json

@@ -9,5 +9,5 @@
   "iot_class": "cloud_push",
   "issue_tracker": "https://github.com/SourceLabOrg/HomeAssistant-PVOutputPublisher/issues",
   "requirements": [],
-  "version": "1.1.0"
+  "version": "1.2.0"
 }

custom_components/pvoutput_publisher/translations/de.json

@@ -18,14 +18,16 @@
           "secondary_entity_id": "Sekundärer Solarsensor (Optional)",
           "consumption_entity_id": "Stromverbrauch-Sensor (Optional)",
           "temperature_entity_id": "Temperatursensor (Optional)",
+          "voltage_entity_id": "Spannungssensor (Optional)",
           "frequency": "Aktualisierungsintervall"
         },
         "data_description": {
           "name": "Ein benutzerfreundlicher Name für Ihre Übersicht.",
           "entity_id": "Der Leistungs- (W) oder Energie- (Wh) Sensor Ihres Wechselrichters.",
           "secondary_entity_id": "Wenn Sie oben einen Leistungs- (W) Sensor ausgewählt haben, wählen Sie hier Ihren Energie- (Wh) Sensor (oder umgekehrt) für maximale Genauigkeit. Wenn leer gelassen, schätzt PVOutput den fehlenden Wert automatisch.",
           "consumption_entity_id": "(Optional) Erfasst den Energieverbrauch Ihres Hauses.",
-          "temperature_entity_id": "(Optional) Erfasst die Außentemperatur."
+          "temperature_entity_id": "(Optional) Erfasst die Außentemperatur.",
+          "voltage_entity_id": "(Optional) Erfasst die Betriebsspannung des Netzes/Wechselrichters."
         }
       },
       "systems_manager": {
@@ -66,14 +68,16 @@
           "secondary_entity_id": "Sekundärer Solarsensor (Optional)",
           "consumption_entity_id": "Stromverbrauch-Sensor (Optional)",
           "temperature_entity_id": "Temperatursensor (Optional)",
+          "voltage_entity_id": "Spannungssensor (Optional)",
           "frequency": "Aktualisierungsintervall"
         },
         "data_description": {
           "name": "Ein benutzerfreundlicher Name für Ihre Übersicht.",
           "entity_id": "Der Leistungs- (W) oder Energie- (Wh) Sensor Ihres Wechselrichters.",
           "secondary_entity_id": "Wenn Sie oben einen Leistungs- (W) Sensor ausgewählt haben, wählen Sie hier Ihren Energie- (Wh) Sensor (oder umgekehrt) für maximale Genauigkeit. Wenn leer gelassen, schätzt PVOutput den fehlenden Wert automatisch.",
           "consumption_entity_id": "(Optional) Erfasst den Energieverbrauch Ihres Hauses.",
-          "temperature_entity_id": "(Optional) Erfasst die Außentemperatur."
+          "temperature_entity_id": "(Optional) Erfasst die Außentemperatur.",
+          "voltage_entity_id": "(Optional) Erfasst die Betriebsspannung des Netzes/Wechselrichters."
         }
       }
     }

custom_components/pvoutput_publisher/translations/en.json

@@ -18,14 +18,16 @@
           "secondary_entity_id": "Secondary Solar Sensor (Optional)",
           "consumption_entity_id": "Consumption Sensor (Optional)",
           "temperature_entity_id": "Temperature Sensor (Optional)",
+          "voltage_entity_id": "Voltage Sensor (Optional)",
           "frequency": "Update Frequency"
         },
         "data_description": {
           "name": "A friendly name for your own reference.",
           "entity_id": "Your inverter's power (W) or energy (Wh) sensor.",
           "secondary_entity_id": "If you selected a Power (W) sensor above, select your Energy (Wh) sensor here (or vice versa) for maximum accuracy. If left blank, PVOutput will automatically estimate the missing value.",
           "consumption_entity_id": "(Optional) Tracks your home's energy usage.",
-          "temperature_entity_id": "(Optional) Tracks outside temperature."
+          "temperature_entity_id": "(Optional) Tracks outside temperature.",
+          "voltage_entity_id": "(Optional) Tracks grid/inverter operational voltage lines."
         }
       },
       "systems_manager": {
@@ -66,14 +68,16 @@
           "secondary_entity_id": "Secondary Solar Sensor (Optional)",
           "consumption_entity_id": "Consumption Sensor (Optional)",
           "temperature_entity_id": "Temperature Sensor (Optional)",
+          "voltage_entity_id": "Voltage Sensor (Optional)",
           "frequency": "Update Frequency"
         },
         "data_description": {
           "name": "A friendly name for your own reference.",
           "entity_id": "Your inverter's power (W) or energy (Wh) sensor.",
           "secondary_entity_id": "If you selected a Power (W) sensor above, select your Energy (Wh) sensor here (or vice versa) for maximum accuracy. If left blank, PVOutput will automatically estimate the missing value.",
           "consumption_entity_id": "(Optional) Tracks your home's energy usage.",
-          "temperature_entity_id": "(Optional) Tracks outside temperature."
+          "temperature_entity_id": "(Optional) Tracks outside temperature.",
+          "voltage_entity_id": "(Optional) Tracks grid/inverter operational voltage lines."
         }
       }
     }

custom_components/pvoutput_publisher/translations/es.json

@@ -18,14 +18,16 @@
           "secondary_entity_id": "Sensor Solar Secundario (Opcional)",
           "consumption_entity_id": "Sensor de Consumo Eléctrico (Opcional)",
           "temperature_entity_id": "Sensor de Temperatura (Opcional)",
+          "voltage_entity_id": "Sensor de Voltaje (Opcional)",
           "frequency": "Frecuencia de Actualización"
         },
         "data_description": {
           "name": "Un nombre descriptivo para su propia referencia.",
           "entity_id": "El sensor de potencia (W) o energía (Wh) de su inversor.",
           "secondary_entity_id": "Si seleccionó un sensor de Potencia (W) arriba, seleccione aquí su sensor de Energía (Wh) (o viceversa) para obtener la máxima precisión. Si se deja en blanco, PVOutput estimará automáticamente el valor faltante.",
           "consumption_entity_id": "(Opcional) Registra el uso de energía de su hogar.",
-          "temperature_entity_id": "(Opcional) Registra la temperatura exterior."
+          "temperature_entity_id": "(Opcional) Registra la temperatura exterior.",
+          "voltage_entity_id": "(Opcional) Registra el voltaje operativo de la red o del inversor."
         }
       },
       "systems_manager": {
@@ -66,14 +68,16 @@
           "secondary_entity_id": "Sensor Solar Secundario (Opcional)",
           "consumption_entity_id": "Sensor de Consumo Eléctrico (Opcional)",
           "temperature_entity_id": "Sensor de Temperatura (Opcional)",
+          "voltage_entity_id": "Sensor de Voltaje (Opcional)",
           "frequency": "Frecuencia de Actualización"
         },
         "data_description": {
           "name": "Un nombre descriptivo para su propia referencia.",
           "entity_id": "El sensor de potencia (W) o energía (Wh) de su inversor.",
           "secondary_entity_id": "Si seleccionó un sensor de Potencia (W) arriba, seleccione aquí su sensor de Energía (Wh) (o viceversa) para obtener la máxima precisión. Si se deja en blanco, PVOutput estimará automáticamente el valor faltante.",
           "consumption_entity_id": "(Opcional) Registra el uso de energía de su hogar.",
-          "temperature_entity_id": "(Opcional) Registra la temperatura exterior."
+          "temperature_entity_id": "(Opcional) Registra la temperatura exterior.",
+          "voltage_entity_id": "(Opcional) Registra el voltaje operativo de la red o del inversor."
         }
       }
     }

custom_components/pvoutput_publisher/translations/ja.json

@@ -18,14 +18,16 @@
           "secondary_entity_id": "サブ太陽光発電センサー (オプション)",
           "consumption_entity_id": "電力/エネルギー消費センサー (オプション)",
           "temperature_entity_id": "温度センサー (オプション)",
+          "voltage_entity_id": "電圧センサー (オプション)",
           "frequency": "更新頻度"
         },
         "data_description": {
           "name": "管理用のわかりやすい名前。",
           "entity_id": "パワーコンディショナの電力 (W) または電力量 (Wh) センサー。",
           "secondary_entity_id": "最大の精度を得るために、上で電力 (W) センサーを選択した場合は、ここで電力量 (Wh) センサーを選択してください（その逆も同様です）。空白の場合、PVOutputは不足している値を自動的に推定します。",
           "consumption_entity_id": "(オプション) 自宅のエネルギー使用量を記録します。",
-          "temperature_entity_id": "(オプション) 外気温を記録します。"
+          "temperature_entity_id": "(オプション) 外気温を記録します。",
+          "voltage_entity_id": "(オプション) グリッドまたはパワーコンディショナの動作電圧を記録します。"
         }
       },
       "systems_manager": {
@@ -66,14 +68,16 @@
           "secondary_entity_id": "サブ太陽光発電センサー (オプション)",
           "consumption_entity_id": "電力/エネルギー消費センサー (オプション)",
           "temperature_entity_id": "温度センサー (オプション)",
+          "voltage_entity_id": "電圧センサー (オプション)",
           "frequency": "更新頻度"
         },
         "data_description": {
           "name": "管理用のわかりやすい名前。",
           "entity_id": "パワーコンディショナの電力 (W) または電力量 (Wh) センサー。",
           "secondary_entity_id": "最大の精度を得るために、上で電力 (W) センサーを選択した場合は、ここで電力量 (Wh) センサーを選択してください（その逆も同様です）。空白の場合、PVOutputは不足している値を自動的に推定します。",
           "consumption_entity_id": "(オプション) 自宅のエネルギー使用量を記録します。",
-          "temperature_entity_id": "(オプション) 外気温を記録します。"
+          "temperature_entity_id": "(オプション) 外気温を記録します。",
+          "voltage_entity_id": "(オプション) グリッドまたはパワーコンディショナの動作電圧を記録します。"
         }
       }
     }