homebridge-viessmann-vicare 2.0.26 → 2.0.28

package/README.md

@@ -203,6 +203,10 @@ Starting from v2.0.25 the plugin automatically records historical data at every
 | Burner starts + hours (lifetime) | Boiler | CSV, HTML report |
 | Outside temperature | Boiler | CSV, HTML report |
 | Outside humidity (if sensor present) | Boiler | CSV, HTML report |
+| PV production (W) + daily yield (kWh) | Energy | CSV, HTML report |
+| Battery level (%) + charge/discharge (W) | Energy | CSV, HTML report |
+| Grid feed-in / draw (W) | Energy | CSV, HTML report |
+| Wallbox charging state + power (W) | Energy | CSV, HTML report |
 
 ---
 
@@ -938,6 +942,28 @@ For issues and questions:
 - 🔧 `scheduleStateRefresh()` replaced by `scheduleCommandConfirmation()` in all three accessories.
 - 🔧 Applied uniformly to `dhw-accessory`, `boiler-accessory`, and `heating-circuit-accessory`.
 
+### [2.0.28] - 2026-03-10
+#### Added
+- **Flow temperature logging** — `heating.circuits.N.sensors.temperature.supply` now read and logged to CSV as `flow_temp` column from HC0 accessory
+- **Real gas consumption logging** — `heating.gas.consumption.summary.heating/dhw.currentDay` (m³) logged as `gas_heating_day_m3` / `gas_dhw_day_m3` columns from boiler accessory
+- **Heat demand estimation** — avg modulation × `nominalPowerKw` config param (default 24 kW) shown in report as stat card
+- **Condensing efficiency badge** — percentage of time flow temp < 55°C displayed in HC0 section with Good/Borderline/Not condensing badge
+- **Burner cycle analysis** — ON/OFF edges reconstructed from CSV; stat cards: cycle count, avg duration, shortest cycle with ⚠ badge if < 5 min
+- **Cycle duration histogram** — bar chart in report (5 buckets: 0–5, 5–10, 10–20, 20–40, 40+ min) shown when ≥ 3 cycles in period
+- **Flow temp chart** — dedicated chart in HC0 section with 55°C condensing threshold line
+- **Flow temp in overview chart** — added as dashed red series on left temperature axis
+- **`nominalPowerKw` config param** — optional, default 24 kW, for heat demand estimation
+
+#### CSV header (v2.0.28)
+`timestamp,accessory,burner_active,modulation,room_temp,target_temp,outside_temp,outside_humidity,dhw_temp,dhw_target,program,mode,burner_starts,burner_hours,flow_temp,gas_heating_day_m3,gas_dhw_day_m3,pv_production_w,pv_daily_kwh,battery_level,battery_charging_w,battery_discharging_w,grid_feedin_w,grid_draw_w,wallbox_charging,wallbox_power_w`
+
+### [2.0.27] - 2026-03-10
+**Added**
+- ⚡ **Energy accessory** (`src/accessories/energy-accessory.ts`): new accessory supporting PV/solar production (Vitocharge VX3 / Vitovolt 300), battery storage, wallbox/EV charger, and electric DHW heater. Capabilities are auto-detected from API features — the accessory is silently skipped if none are present. HomeKit mapping: PV → Lightbulb (brightness = production %), Battery → Battery service + Lightbulb for power, Wallbox → Switch (enable/disable) + Outlet (plugged-in status), Electric DHW → HeaterCooler.
+- ⚡ **Energy CSV logging**: energy accessory logs PV production (W), daily yield (kWh), battery level (%), charging/discharging power (W), grid feed-in/draw (W), wallbox charging state and power (W) to `viessmann-history.csv` every refresh cycle.
+- 📊 **HTML report — Energy section**: new *Energy System* section in the report with stat cards and Chart.js graphs for PV production, battery level + charge/discharge, and wallbox power. Sections are shown only when data is present.
+- 📊 **CSV columns added**: `pv_production_w`, `pv_daily_kwh`, `battery_level`, `battery_charging_w`, `battery_discharging_w`, `grid_feedin_w`, `grid_draw_w`, `wallbox_charging`, `wallbox_power_w` appended after existing columns. Backward compatible — empty for non-energy rows.
+
 ### [2.0.26] - 2026-03-10
 **Added**
 - 🌐 **HTML report — Overview chart**: new all-in-one chart at the top of the report with dual Y axis combining room temperature, HC0 setpoint, DHW temperature, outside temperature, modulation (%), burner ON/OFF, and outside humidity (when sensor is present). Series from different accessories are aligned on a unified timeline using linear interpolation for continuous, gap-free lines.

package/dist/accessories/boiler-accessory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"boiler-accessory.d.ts","sourceRoot":"","sources":["../../src/accessories/boiler-accessory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE7E,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,eAAe,EAA2B,MAAM,aAAa,CAAC;AAEnI,qBAAa,wBAAwB;IAkDjC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IArDzB,OAAO,CAAC,mBAAmB,CAAU;IACrC,OAAO,CAAC,kBAAkB,CAAU;IACpC,OAAO,CAAC,iBAAiB,CAAC,CAAU;IACpC,OAAO,CAAC,aAAa,CAAC,CAAU;IAGhC,OAAO,CAAC,yBAAyB,CAAC,CAAU;IAC5C,OAAO,CAAC,qBAAqB,CAAC,CAAU;IACxC,OAAO,CAAC,uBAAuB,CAAC,CAAU;IAC1C,OAAO,CAAC,uBAAuB,CAAC,CAAU;IAC1C,OAAO,CAAC,qBAAqB,CAAC,CAAU;IACxC,OAAO,CAAC,uBAAuB,CAAC,CAAU;IAC1C,OAAO,CAAC,oBAAoB,CAAC,CAAU;IAEvC,OAAO,CAAC,0BAA0B,CAAS;IAC3C,OAAO,CAAC,aAAa,CAAC,CAAyB;IAC/C,OAAO,CAAC,sBAAsB,CAAwB;IACtD,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,iBAAiB,CAAK;IAG9B,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,mBAAmB,CAAiC;IAC5D,OAAO,CAAC,mBAAmB,CAAiC;IAE5D,OAAO,CAAC,MAAM,CAqBZ;gBAGiB,QAAQ,EAAE,iBAAiB,EAC3B,SAAS,EAAE,iBAAiB,EAC5B,YAAY,EAAE,qBAAqB,EACnC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,eAAe;YA0B5B,sBAAsB;IAmBpC,OAAO,CAAC,mBAAmB;IA2E3B,OAAO,CAAC,oBAAoB;IAiB5B,OAAO,CAAC,yBAAyB;IAoBjC,OAAO,CAAC,wBAAwB;IAoEhC,OAAO,CAAC,kBAAkB;IAwD1B,OAAO,CAAC,sBAAsB;IAyE9B,OAAO,CAAC,uBAAuB;IAmO/B,OAAO,CAAC,gCAAgC;IAqCxC,OAAO,CAAC,2BAA2B;IAInC,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,gBAAgB;IAIlB,qBAAqB,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAIrD,8BAA8B,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAI9D,8BAA8B,CAAC,KAAK,EAAE,mBAAmB;IA8C/D,OAAO,CAAC,2BAA2B;YAiDrB,YAAY;YAYZ,kBAAkB;IAqVzB,oBAAoB,IAAI;QAC7B,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;QACxC,mBAAmB,EAAE,MAAM,CAAC;QAC5B,sBAAsB,EAAE,MAAM,CAAC;QAC/B,qBAAqB,EAAE,MAAM,CAAC;QAC9B,wBAAwB,EAAE,MAAM,CAAC;QACjC,kBAAkB,EAAE,MAAM,CAAC;QAC3B,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;KACtB;CAsBF"}
+{"version":3,"file":"boiler-accessory.d.ts","sourceRoot":"","sources":["../../src/accessories/boiler-accessory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE7E,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,eAAe,EAA2B,MAAM,aAAa,CAAC;AAEnI,qBAAa,wBAAwB;IAmDjC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAtDzB,OAAO,CAAC,mBAAmB,CAAU;IACrC,OAAO,CAAC,kBAAkB,CAAU;IACpC,OAAO,CAAC,iBAAiB,CAAC,CAAU;IACpC,OAAO,CAAC,aAAa,CAAC,CAAU;IAGhC,OAAO,CAAC,yBAAyB,CAAC,CAAU;IAC5C,OAAO,CAAC,qBAAqB,CAAC,CAAU;IACxC,OAAO,CAAC,uBAAuB,CAAC,CAAU;IAC1C,OAAO,CAAC,uBAAuB,CAAC,CAAU;IAC1C,OAAO,CAAC,qBAAqB,CAAC,CAAU;IACxC,OAAO,CAAC,uBAAuB,CAAC,CAAU;IAC1C,OAAO,CAAC,oBAAoB,CAAC,CAAU;IAEvC,OAAO,CAAC,0BAA0B,CAAS;IAC3C,OAAO,CAAC,aAAa,CAAC,CAAyB;IAC/C,OAAO,CAAC,sBAAsB,CAAwB;IACtD,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,iBAAiB,CAAK;IAG9B,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,mBAAmB,CAAiC;IAC5D,OAAO,CAAC,mBAAmB,CAAiC;IAE5D,OAAO,CAAC,MAAM,CAsBZ;gBAGiB,QAAQ,EAAE,iBAAiB,EAC3B,SAAS,EAAE,iBAAiB,EAC5B,YAAY,EAAE,qBAAqB,EACnC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,eAAe;YA0B5B,sBAAsB;IAmBpC,OAAO,CAAC,mBAAmB;IA2E3B,OAAO,CAAC,oBAAoB;IAiB5B,OAAO,CAAC,yBAAyB;IAoBjC,OAAO,CAAC,wBAAwB;IAoEhC,OAAO,CAAC,kBAAkB;IAwD1B,OAAO,CAAC,sBAAsB;IAyE9B,OAAO,CAAC,uBAAuB;IAmO/B,OAAO,CAAC,gCAAgC;IAqCxC,OAAO,CAAC,2BAA2B;IAInC,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,gBAAgB;IAIlB,qBAAqB,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAIrD,8BAA8B,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAI9D,8BAA8B,CAAC,KAAK,EAAE,mBAAmB;IA8C/D,OAAO,CAAC,2BAA2B;YAiDrB,YAAY;YAYZ,kBAAkB;IA6VzB,oBAAoB,IAAI;QAC7B,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;QACxC,mBAAmB,EAAE,MAAM,CAAC;QAC5B,sBAAsB,EAAE,MAAM,CAAC;QAC/B,qBAAqB,EAAE,MAAM,CAAC;QAC9B,wBAAwB,EAAE,MAAM,CAAC;QACjC,kBAAkB,EAAE,MAAM,CAAC;QAC3B,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;KACtB;CAsBF"}

package/dist/accessories/boiler-accessory.js

@@ -43,6 +43,7 @@ class ViessmannBoilerAccessory {
         GasConsumptionToday: 0,
         GasConsumptionThisMonth: 0,
         GasConsumptionThisYear: 0,
+        GasConsumptionDhwToday: 0, // heating.gas.consumption.summary.dhw.currentDay
         PowerConsumptionToday: 0,
         PowerConsumptionThisMonth: 0,
         PowerConsumptionThisYear: 0,
@@ -748,6 +749,11 @@ class ViessmannBoilerAccessory {
                 this.states.GasConsumptionThisYear = gasConsumptionFeature.properties.currentYear.value;
             }
         }
+        // Update DHW gas consumption
+        const gasDhwFeature = features.find(f => f.feature === 'heating.gas.consumption.summary.dhw');
+        if (gasDhwFeature?.properties?.currentDay?.value !== undefined) {
+            this.states.GasConsumptionDhwToday = gasDhwFeature.properties.currentDay.value;
+        }
         // Update gas consumption occupancy sensor
         if (gasDataUpdated && this.gasConsumptionService) {
             const hasActiveConsumption = this.states.GasConsumptionToday > 0.1;
@@ -904,6 +910,8 @@ class ViessmannBoilerAccessory {
                 outside_humidity: this.states.OutsideHumidity,
                 burner_starts: this.states.BurnerStarts,
                 burner_hours: this.states.BurnerHours,
+                gas_heating_day_m3: this.states.GasConsumptionToday || undefined,
+                gas_dhw_day_m3: this.states.GasConsumptionDhwToday || undefined,
             });
         }
     }

package/dist/accessories/energy-accessory.d.ts

@@ -0,0 +1,53 @@
+import { PlatformAccessory } from 'homebridge';
+import { ViessmannPlatform, ViessmannInstallation, ViessmannGateway, ViessmannDevice } from '../platform';
+/**
+ * ViessmannEnergyAccessory
+ *
+ * Handles energy-related Viessmann devices:
+ *  - Vitocharge VX3 / photovoltaic system  (heating.solar / heating.photovoltaic)
+ *  - Battery storage                        (heating.buffer / heating.powerStorage)
+ *  - Wallbox / EV charger                  (charging.ev.*)
+ *  - Electric DHW heater                   (heating.dhw.heating.*)
+ *
+ * HomeKit mapping:
+ *  - PV production      → Lightbulb (Brightness = watts %)
+ *  - Battery level      → Battery service
+ *  - Grid feed-in       → Switch (read-only via Eve-like sensor)
+ *  - Wallbox charging   → Switch (on/off) + Outlet
+ *  - Electric DHW       → HeaterCooler
+ */
+export declare class ViessmannEnergyAccessory {
+    private readonly platform;
+    private readonly accessory;
+    private readonly installation;
+    private readonly gateway;
+    private readonly device;
+    private historyLogger?;
+    private informationService;
+    private pvProductionService?;
+    private pvStatusService?;
+    private batteryService?;
+    private batteryPowerService?;
+    private wallboxService?;
+    private wallboxOutletService?;
+    private electricDHWService?;
+    private hasPV;
+    private hasBattery;
+    private hasWallbox;
+    private hasElectricDHW;
+    private states;
+    constructor(platform: ViessmannPlatform, accessory: PlatformAccessory, installation: ViessmannInstallation, gateway: ViessmannGateway, device: ViessmannDevice);
+    private initializeCapabilities;
+    private detectCapabilities;
+    private setupServices;
+    private setupPVServices;
+    private setupBatteryServices;
+    private setupWallboxServices;
+    private setupElectricDHWService;
+    handleUpdate(): Promise<void>;
+    private updateFromFeatures;
+    private setWallboxCharging;
+    private setElectricDHWActive;
+    private setElectricDHWTemperature;
+}
+//# sourceMappingURL=energy-accessory.d.ts.map

package/dist/accessories/energy-accessory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"energy-accessory.d.ts","sourceRoot":"","sources":["../../src/accessories/energy-accessory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,iBAAiB,EAAuB,MAAM,YAAY,CAAC;AAC7E,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EAChB,MAAM,aAAa,CAAC;AAGrB;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,wBAAwB;IA8DjC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IA/DzB,OAAO,CAAC,aAAa,CAAC,CAAyB;IAG/C,OAAO,CAAC,kBAAkB,CAAU;IAGpC,OAAO,CAAC,mBAAmB,CAAC,CAAU;IACtC,OAAO,CAAC,eAAe,CAAC,CAAU;IAGlC,OAAO,CAAC,cAAc,CAAC,CAAU;IACjC,OAAO,CAAC,mBAAmB,CAAC,CAAU;IAGtC,OAAO,CAAC,cAAc,CAAC,CAAU;IACjC,OAAO,CAAC,oBAAoB,CAAC,CAAU;IAGvC,OAAO,CAAC,kBAAkB,CAAC,CAAU;IAGrC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,cAAc,CAAS;IAG/B,OAAO,CAAC,MAAM,CA6BZ;gBAGiB,QAAQ,EAAE,iBAAiB,EAC3B,SAAS,EAAE,iBAAiB,EAC5B,YAAY,EAAE,qBAAqB,EACnC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,eAAe;YA2B5B,sBAAsB;IAqBpC,OAAO,CAAC,kBAAkB;IAkE1B,OAAO,CAAC,aAAa;IAuBrB,OAAO,CAAC,eAAe;IAsCvB,OAAO,CAAC,oBAAoB;IA0E5B,OAAO,CAAC,oBAAoB;IA8C5B,OAAO,CAAC,uBAAuB;IA8DlB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;YAa5B,kBAAkB;YAkMlB,kBAAkB;YAsBlB,oBAAoB;YAsBpB,yBAAyB;CAkBxC"}