fix: Optimize WRG efficiency update rate, correct NTC mapping, and eliminate UI lag

Author: thengeroff

CHANGELOG.md

@@ -5,8 +5,19 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [0.8.259] - 2026-05-13
+## [0.9.1] - 2026-05-14
+
+### Fixed
+- **UI Latenz & Synchronisation**: Behebung drastischer Verzögerungen bei der Aktualisierung von Template-Sensoren im Home Assistant Dashboard (z.B. "Lüfter Richtung" und "WRG Effizienz").
+- **Event-Driven Template Sensors**: Fehlende `update_interval` Angaben führten dazu, dass Template-Sensoren, die auf C++ Variablen (`globals`) basieren, auf den langsamen 60-Sekunden Standard-Polling-Zyklus von ESPHome zurückfielen. Entsprechende Sensoren erzwingen nun via `update_interval: 1s` oder `5s` sofortige HA-Statusupdates.
+- **WRG-Effizienz Schwebung**: Ein statisches 60-Sekunden-Intervall führte dazu, dass die Effizienz-Berechnung fast nie das korrekte 42-Sekunden-Zuluft-Fenster traf. Dies wurde in einen Event-gesteuerten Modus mit 5-Sekunden-Takt (`update_interval: 5s`) umgeschrieben. Die Effizienzkurve wird nun live und hochauflösend gerendert.
 
+### Changed
+- **NTC Sensor Mapping**: Konsequenter Tausch der NTC-Rollen zur physischen Realität: `temp_abluft` repräsentiert die Referenz-Innentemperatur (gemessen während der Abluft-Phase), während `temp_zuluft` die Außentemperatur repräsentiert.
+- **Median-Filter Tuning**: Anpassung der Window-Send-Rate in `sensor_NTC.yaml` (`send_every: 3` -> `1`), um die trägen thermischen Messwerte mit der sehr kurzen 70-Sekunden Richtungsphase zu synchronisieren und das "Verschlucken" von gültigen Fenstern zu beenden.
+- **CO2 Bewertung**: Die Text-Klassifizierung ("Gut", "Schlecht") reagiert nun ohne 60-Sekunden Verzögerung latenzfrei auf Änderungen des darunterliegenden CO2-Wertes.
+
+## [0.8.259] - 2026-05-13
 ### Fixed
 - **UI Responsiveness**: Resolved an issue where the "Lüfter Intensität" slider and "ESP-NOW Peerprüfung" switch in Home Assistant would take up to 60 seconds to update or revert to their previous state.
 - Added explicit `publish_state()` calls to the `set_action` and `turn_on/off_action` blocks for template entities configured with `optimistic: false`.

components/helpers/auto_mode.h

@@ -138,12 +138,12 @@ inline void get_effective_temperatures(uint32_t now, float &eff_in, float &eff_o
         local_out = read_sensor(temp_zuluft);
         if (std::isnan(local_in)) local_in = read_sensor(temp_abluft);
     } else {
-        local_out = read_sensor(temp_abluft);
-        if (std::isnan(local_in)) local_in = read_sensor(temp_zuluft);
+        local_out = read_sensor(temp_zuluft);
+        if (std::isnan(local_in)) local_in = read_sensor(temp_abluft);
     }
   } else if (internal_mode == esphome::MODE_ECO_RECOVERY) {
-    local_out = read_sensor(temp_abluft);
-    if (std::isnan(local_in)) local_in = read_sensor(temp_zuluft);
+    local_out = read_sensor(temp_zuluft);
+    if (std::isnan(local_in)) local_in = read_sensor(temp_abluft);
   }
 
   // Update controller state for networking

components/helpers/climate.h

@@ -35,6 +35,11 @@ inline std::string get_co2_classification(float co2_ppm) {
   return VentilationLogic::get_co2_classification(co2_ppm);
 }
 
+// Stabilization parameter constants
+constexpr float NTC_MAX_DEVIATION = 0.3f;
+constexpr uint32_t NTC_MIN_WAIT_MS = 15000;
+constexpr size_t NTC_WINDOW_SIZE = 3;
+
 /**
  * @brief   Calculates the heat recovery efficiency fraction (0.0 – 1.0).
  *
@@ -48,7 +53,7 @@ inline std::string get_co2_classification(float co2_ppm) {
  * @param[in] t_aussen    Outside ambient air temperature.
  * @param[in] current_eff The last calculated efficiency (to hold during flips).
  */
-inline float calculate_heat_recovery_efficiency(float t_raum, float t_zuluft,
+inline float calculate_heat_recovery_efficiency(float t_raum, float t_zuluft_live,
                                                 float t_aussen,
                                                 float current_eff) {
   if (ventilation_ctrl == nullptr)
@@ -59,79 +64,67 @@ inline float calculate_heat_recovery_efficiency(float t_raum, float t_zuluft,
   const auto hw = ventilation_ctrl->state_machine.get_target_state(now);
 
   const bool is_wrg = (mode == esphome::MODE_ECO_RECOVERY);
-  const bool is_intake = hw.direction_in;
+  const bool is_intake = hw.direction_in; // Zuluft-Phase (von außen nach innen)
 
-  // Abort if NTC sensors are disconnected (usually report ~87°C) or invalid
-  if (std::isnan(t_zuluft) || std::isnan(t_aussen) || t_zuluft > 80.0f || t_aussen > 80.0f) {
-    return NAN;
+  // Abort if sensors are disconnected or invalid
+  if (std::isnan(t_zuluft_live) || std::isnan(t_aussen) || std::isnan(t_raum)) {
+    return current_eff;
   }
 
-  // Boot-Guard: Keine Messung in den ersten 60s nach Boot
+  // Boot-Guard: Keine Messung in den ersten 60s
   static bool boot_complete = false;
   if (!boot_complete) {
     if (now < 60000) return current_eff;
     boot_complete = true;
   }
 
-  // Thermal stabilization: Wait at least 30s into the cycle before sampling
-  constexpr uint32_t stable_time_ms = 30000;
   const uint32_t time_since_flip = now - last_direction_change_time;
-  // Sicherstellen dass mindestens EIN echter Richtungswechsel stattgefunden hat
   const bool had_real_flip = (last_direction_change_time > 0);
-  const bool is_stable = had_real_flip && (time_since_flip > stable_time_ms);
 
+  // Dynamische Wartezeit, um die NTC-Anpassungsphase nach dem Richtungswechsel auszulassen (analog filter_ntc_stable)
+  const uint32_t cycle_ms = ventilation_ctrl->state_machine.cycle_duration_ms;
+  uint32_t wait_ms = NTC_MIN_WAIT_MS;
+  if (cycle_ms > 0) {
+      wait_ms = std::clamp(
+          static_cast<uint32_t>(cycle_ms * 0.4f),
+          NTC_MIN_WAIT_MS,
+          cycle_ms > 5000 ? cycle_ms - 5000 : cycle_ms / 2
+      );
+  }
+
+  const bool is_stable = had_real_flip && (time_since_flip > wait_ms);
+
+  // Messung nur während der Zuluft-Phase, NACH der Anpassungsphase
   if (is_wrg && is_intake && is_stable) {
-    if (std::isnan(t_raum)) {
-      ESP_LOGD("climate", "WRG Efficiency: Room sensor data NaN, holding: %.1f%%", current_eff);
-      return current_eff;
-    }
+    // Effizienz berechnen. VentilationLogic gibt 0.0 bis 100.0 zurück.
     float eff = VentilationLogic::calculate_heat_recovery_efficiency(
-        t_raum, t_zuluft, t_aussen);
+        t_raum, t_zuluft_live, t_aussen);
 
-    // NaN abfangen (z.B. wenn T_raum == T_aussen -> Division durch 0)
     if (std::isnan(eff) || std::isinf(eff)) {
-        ESP_LOGW("climate", 
-            "WRG efficiency calculation returned invalid value "
-            "(T_raum=%.1f, T_zuluft=%.1f, T_aussen=%.1f) — holding %.1f%%",
-            t_raum, t_zuluft, t_aussen, current_eff * 100.0f);
         return current_eff;
     }
 
     // Physikalisch sinnvoller Bereich: 0% bis 110%
-    if (eff < 0.0f || eff > 1.1f) {
+    if (eff < 0.0f || eff > 110.0f) {
         ESP_LOGW("climate",
             "WRG efficiency out of plausible range: %.1f%% "
-            "(T_raum=%.1f, T_zuluft=%.1f, T_aussen=%.1f)",
-            eff * 100.0f, t_raum, t_zuluft, t_aussen);
-        return current_eff; // Halte letzten gültigen Wert
+            "(T_raum=%.1f, T_zuluft_live=%.1f, T_aussen=%.1f)",
+            eff, t_raum, t_zuluft_live, t_aussen);
+        return current_eff;
     }
 
-    // Soft-Clamp für Anzeige: Werte zwischen 0% und 100%
-    eff = std::clamp(eff, 0.0f, 1.0f);
+    // Soft-Clamp für Anzeige auf 0-100%
+    eff = std::clamp(eff, 0.0f, 100.0f);
 
-    ESP_LOGD("climate", "WRG Efficiency update: %.1f%% (Room:%.1f Zuluft:%.1f Out:%.1f)", 
-             eff * 100.0f, t_raum, t_zuluft, t_aussen);
+    ESP_LOGD("climate", "WRG Efficiency update: %.1f%% (Room:%.1f Zuluft_Live:%.1f Out:%.1f)", 
+             eff, t_raum, t_zuluft_live, t_aussen);
     return eff;
   }
 
-  // Debugging holding reasons (only in WRG mode to avoid log spam)
-  if (is_wrg) {
-    if (!is_intake) {
-      ESP_LOGD("climate", "WRG Efficiency: Holding during exhaust phase (Abluft)");
-    } else if (!is_stable) {
-      ESP_LOGD("climate", "WRG Efficiency: Waiting for stabilization (%us remaining)", 
-               (stable_time_ms - time_since_flip) / 1000);
-    }
-  }
-
-  // Not in a valid sampling window → hold last known value
   return current_eff;
 }
 
-// Stabilization parameter constants
-constexpr float NTC_MAX_DEVIATION = 0.3f;
-constexpr uint32_t NTC_MIN_WAIT_MS = 15000;
-constexpr size_t NTC_WINDOW_SIZE = 3;
+
 
 /**
  * @brief   NTC Sliding Window Stabilization Filter.
@@ -142,7 +135,7 @@ constexpr size_t NTC_WINDOW_SIZE = 3;
  *          to the ceramic core, which has high thermal inertia and
  *          requires time to "settle" after each direction change.
  *
- * @param[in] sensor_idx  0 for temp_zuluft, 1 for temp_abluft.
+ * @param[in] sensor_idx  0 for temp_abluft (NTC Innen), 1 for temp_zuluft (NTC Außen).
  * @param[in] new_value   The raw value reported by the physical NTC component.
  *
  * @return  The original value if stable, else an empty optional to discard the update.
@@ -167,6 +160,17 @@ inline esphome::optional<float> filter_ntc_stable(int sensor_idx,
     return new_value;
   }
 
+  // --- NEU: Richtungs-Sperre (Phase-Lock) ---
+  // NTC 0 (Innen) misst die wahre Innentemperatur nur während der Abluft-Phase (Luft strömt nach außen)
+  // NTC 1 (Außen) misst die wahre Außentemperatur nur während der Zuluft-Phase (Luft strömt nach innen)
+  const auto hw = ventilation_ctrl->state_machine.get_target_state(millis());
+  if (sensor_idx == 0 && hw.direction_in) {
+      return {}; // Zuluft-Phase: Innensensor misst aufgewärmte Luft -> Wert für T_raum halten!
+  }
+  if (sensor_idx == 1 && !hw.direction_in) {
+      return {}; // Abluft-Phase: Außensensor misst abgekühlte Luft -> Wert für T_aussen halten!
+  }
+
   const uint32_t cycle_ms = ventilation_ctrl->state_machine.cycle_duration_ms;
   if (cycle_ms == 0) return new_value;
 

components/helpers/globals.h

@@ -284,9 +284,8 @@ extern esphome::binary_sensor::BinarySensor *const radar_presence; ///< Presence
 extern esphome::template_::TemplateSensor
     *const effective_co2; ///< Unified CO2 sensor (SCD41 or BME680 fallback).
 extern esphome::sensor::Sensor *const temperature; ///< Room Temperature (SCD41)
-extern esphome::ntc::NTC *const temp_zuluft; ///< Supply Air Temperature (NTC Inside)
-extern esphome::ntc::NTC
-    *const temp_abluft; ///< Exhaust Air Temperature (NTC Outside)
+extern esphome::ntc::NTC *const temp_zuluft; ///< Outside Air Temperature (NTC Outside)
+extern esphome::ntc::NTC *const temp_abluft; ///< Inside Air Temperature (NTC Inside)
 extern esphome::homeassistant::HomeassistantSensor
     *const outdoor_humidity; ///< Outdoor Humidity (HA)
 extern esphome::homeassistant::HomeassistantBinarySensor

manifest_example.json

@@ -1,11 +1,11 @@
 {
   "name": "thomasengeroff.ventosync",
-  "version": "0.8.260",
+  "version": "0.9.1",
   "builds": [
     {
       "chipFamily": "ESP32-C6",
       "ota": {
-        "md5": "13e39d0e76ec8c94d4f8e4010d3db65b",
+        "md5": "5c0cb56a10c13c513bc31ff1b7026136",
         "path": "firmware.bin",
         "summary": "OTA update check frequency set to 15 minutes"
       }

packages/base/esp32c6_common.yaml

@@ -30,6 +30,7 @@ substitutions:
   <<: !include ../../version.json
 
   hide_climate_sensors: "false"
+  hide_ntc_sensors: "false"
   # Firmware variant identifier for OTA manifest selection.
   # Override in each variant YAML (e.g., ventosync-nosensor, ventosync-radar-only).
   firmware_variant: "ventosync-full"

packages/sensors/sensor_NTC.yaml

@@ -51,20 +51,33 @@ sensor:
 
   - platform: ntc
     sensor: ntc_innen_resistance
-    name: "WRG Temperatur Zuluft (Innen)"
-    id: temp_zuluft
+    name: "Temp. Abluft (Innen)"
+    id: temp_abluft
+    internal: ${hide_ntc_sensors}
     calibration:
       b_constant: 3976 # Beta coefficient from datasheet
       reference_temperature: 25°C
       reference_resistance: 10kOhm
     accuracy_decimals: 1
     filters:
       - median:
-          window_size: 5
-          send_every: 3
+          window_size: 3
+          send_every: 1
       - lambda: |-
           return filter_ntc_stable(0, x);
 
+  - platform: ntc
+    sensor: ntc_innen_resistance
+    name: "Temp. Abluft (Innen) RAW"
+    id: temp_abluft_raw
+    internal: ${hide_ntc_sensors}
+    calibration:
+      b_constant: 3976 # Beta coefficient from datasheet
+      reference_temperature: 25°C
+      reference_resistance: 10kOhm
+    accuracy_decimals: 1
+    entity_category: diagnostic
+
   - platform: adc
     id: ntc_innen_source
     pin: GPIO1 # Pin D1
@@ -83,20 +96,33 @@ sensor:
 
   - platform: ntc
     sensor: ntc_aussen_resistance
-    name: "WRG Temperatur Abluft (Außen)"
-    id: temp_abluft
+    name: "Temp. Zuluft (Außen)"
+    id: temp_zuluft
+    internal: ${hide_ntc_sensors}
     calibration:
       b_constant: 3976 # Beta coefficient from datasheet
       reference_temperature: 25°C
       reference_resistance: 10kOhm
     accuracy_decimals: 1
     filters:
       - median:
-          window_size: 5
-          send_every: 3
+          window_size: 3
+          send_every: 1
       - lambda: |-
           return filter_ntc_stable(1, x);
 
+  - platform: ntc
+    sensor: ntc_aussen_resistance
+    name: "Temp. Zuluft (Außen) RAW"
+    id: temp_zuluft_raw
+    internal: ${hide_ntc_sensors}
+    calibration:
+      b_constant: 3976 # Beta coefficient from datasheet
+      reference_temperature: 25°C
+      reference_resistance: 10kOhm
+    accuracy_decimals: 1
+    entity_category: diagnostic
+
   - platform: adc
     id: ntc_aussen_source
     pin: GPIO0 # Pin D0

packages/sensors/sensors_climate.yaml

@@ -37,23 +37,27 @@ sensor:
   - platform: template
     name: "WRG Effizienz"
     id: heat_recovery_efficiency
-    internal: ${hide_climate_sensors}
+    internal: ${hide_ntc_sensors}
     unit_of_measurement: "%"
     state_class: "measurement"
     accuracy_decimals: 1
     icon: "mdi:percent"
-    update_interval: 60s
+    update_interval: 5s
     lambda: |-
-      float t_in = id(scd41_temperature).state;
-      if (std::isnan(t_in)) t_in = id(bme680_temperature).state;
+      // Raumtemperatur (NTC Innen gefiltert, geloggt während Abluft)
+      float t_in = id(temp_abluft).state;
+      // Außentemperatur (NTC Außen gefiltert, geloggt während Zuluft)
+      float t_out = id(temp_zuluft).state;
+      // Aktuelle Zulufttemperatur nach Keramiktausch (RAW, ungefiltert)
+      float t_live = id(temp_abluft_raw).state;
 
-      // Abort calculation if no valid room temperature is available
-      if (std::isnan(t_in)) return NAN;
+      // Abort calculation if no valid base temperatures are available
+      if (std::isnan(t_in) || std::isnan(t_out) || std::isnan(t_live)) return NAN;
 
       return calculate_heat_recovery_efficiency(
-        t_in,                         // Room temperature (SCD41 or BME680 only!)
-        id(temp_zuluft).state,        // Supply air temperature
-        id(temp_abluft).state,        // Exhaust air temperature
+        t_in,                         // T_raum
+        t_live,                       // T_zuluft (live)
+        t_out,                        // T_aussen
         id(heat_recovery_efficiency).state
       );
 
@@ -97,19 +101,16 @@ text_sensor:
     id: effective_co2_bewertung
     internal: ${hide_climate_sensors}
     icon: "mdi:circle-slice-8"
-    update_interval: 60s
     lambda: |-
       return get_co2_classification(id(effective_co2).state);
 
   # Human-readable info about which sensor is used for WRG efficiency
   - platform: template
     name: "WRG Referenz-Messpunkt"
     id: wrg_reference_sensor
-    internal: ${hide_climate_sensors}
+    internal: ${hide_ntc_sensors}
     icon: "mdi:target-variant"
     update_interval: 60s
     lambda: |-
-      if (!std::isnan(id(scd41_temperature).state)) return std::string("SCD41");
-      if (!std::isnan(id(bme680_temperature).state)) return std::string("BME680");
-      return std::string("Kein Raumsensor");
+      return std::string("NTC Sensoren");
 

packages/ui/ui_controls.yaml

@@ -235,6 +235,7 @@ text_sensor:
     name: "Lüfter Richtung"
     id: direction_display
     icon: "mdi:directions-fork"
+    update_interval: 1s
     lambda: |-
       static std::string last_state = "";
       std::string current_state = "";