homebridge-enphase-envoy 10.7.2 → 10.7.3

package/CHANGELOG.md

@@ -11,6 +11,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - For plugin >= v10.4.0 use Homebridge UI >= v5.13.0
 - after update to v10.0.0 and above the accessory and bridge need to be removed from the homebridge / Home.app and added again
 
+## [10.7.3] - (14.05.2026)
+
+### Changed
+
+- Energy history: `prit`, `cnit`, `ctit` spike after a connection gap is now distributed evenly across all preceding null records and the first real record; when data resumes after N missing minutes, each slot receives `delta / (N + 1)` instead of all accumulation appearing in one record; previously saved null records on disk are also retroactively backfilled when a real record finally follows them
+
 ## [10.7.2] - (14.05.2026)
 
 ### Fixed

package/README.md

@@ -320,8 +320,8 @@ The plugin integrates Enphase Envoy solar energy monitoring systems with Homebri
 REST POST calls must include a content-type header of `application/json`.
 Path `pv` response all available data.
 Path `status` response all available paths.
-Energy history stored every 1 minute at `:00` second and at `23:59:59` each day. Missing records are filled with `null` values. Retention is controlled by `energyHistoryTime` and `energyHistoryReserveSpace` settings:
-`ts - timestamp`, `pr - production lifetime`, `prit - production interval Wh (same day only)`, `prt - production today`, `pru - production lifetime upload`, `prut - production today upload`, `cn - consumption net lifetime`, `cnit - net consumption interval Wh (same day only)`, `cnt - consumption net today`, `cnu - consumption net lifetime upload`, `cnut - consumption net today upload`, `ct - consumption total lifetime`, `ctit - total consumption interval Wh (same day only)`, `ctt - consumption total today`, `ctp - consumption total lifetime from pv`, `ctpt - consumption total today from pv`
+Energy history stored every 1 minute at `:00` second and at `23:59:59` each day. Missing records are filled with `null` values; interval fields (`prit`, `cnit`, `ctit`) for gap records are distributed evenly across the gap when data resumes. Retention is controlled by `energyHistoryTime` and `energyHistoryReserveSpace` settings:
+`ts - timestamp`, `pr - production lifetime`, `prit - production interval Wh between records (same day only, evenly distributed across gaps)`, `prt - production today`, `pru - production lifetime upload`, `prut - production today upload`, `cn - consumption net lifetime`, `cnit - net consumption interval Wh between records (same day only, evenly distributed across gaps)`, `cnt - consumption net today`, `cnu - consumption net lifetime upload`, `cnut - consumption net today upload`, `ct - consumption total lifetime`, `ctit - total consumption interval Wh between records (same day only, evenly distributed across gaps)`, `ctt - consumption total today`, `ctp - consumption total lifetime from pv`, `ctpt - consumption total today from pv`
 
 | Method | URL | Path | Response | Type |
 | --- | --- | --- | --- | --- |
@@ -341,8 +341,8 @@ Energy history stored every 1 minute at `:00` second and at `23:59:59` each day.
 ### MQTT Integration
 
 Subscribe using JSON `{ "EnchargeProfile": "savings" }`
-Energy history stored every 1 minute at `:00` second and at `23:59:59` each day. Missing records are filled with `null` values. Retention is controlled by `energyHistoryTime` and `energyHistoryReserveSpace` settings:
-`ts - timestamp`, `pr - production lifetime`, `prit - production interval Wh (same day only)`, `prt - production today`, `pru - production lifetime upload`, `prut - production today upload`, `cn - consumption net lifetime`, `cnit - net consumption interval Wh (same day only)`, `cnt - consumption net today`, `cnu - consumption net lifetime upload`, `cnut - consumption net today upload`, `ct - consumption total lifetime`, `ctit - total consumption interval Wh (same day only)`, `ctt - consumption total today`, `ctp - consumption total lifetime from pv`, `ctpt - consumption total today from pv`
+Energy history stored every 1 minute at `:00` second and at `23:59:59` each day. Missing records are filled with `null` values; interval fields (`prit`, `cnit`, `ctit`) for gap records are distributed evenly across the gap when data resumes. Retention is controlled by `energyHistoryTime` and `energyHistoryReserveSpace` settings:
+`ts - timestamp`, `pr - production lifetime`, `prit - production interval Wh between records (same day only, evenly distributed across gaps)`, `prt - production today`, `pru - production lifetime upload`, `prut - production today upload`, `cn - consumption net lifetime`, `cnit - net consumption interval Wh between records (same day only, evenly distributed across gaps)`, `cnt - consumption net today`, `cnu - consumption net lifetime upload`, `cnut - consumption net today upload`, `ct - consumption total lifetime`, `ctit - total consumption interval Wh between records (same day only, evenly distributed across gaps)`, `ctt - consumption total today`, `ctp - consumption total lifetime from pv`, `ctpt - consumption total today from pv`
 
 | Method | Topic | Message | Type |
 | --- | --- | --- | --- |

package/package.json

@@ -2,7 +2,7 @@
     "private": false,
     "displayName": "Enphase Envoy",
     "name": "homebridge-enphase-envoy",
-    "version": "10.7.2",
+    "version": "10.7.3",
     "description": "Homebridge plugin for Photovoltaic Energy System manufactured by Enphase.",
     "license": "MIT",
     "author": "grzegorz914",

package/src/envoydevice.js

@@ -4373,6 +4373,7 @@ class EnvoyDevice extends EventEmitter {
 
                                     const lastTs = energyHistory.reduce((max, item) => (item?.ts > max ? item.ts : max), 0);
                                     const targetTs = needsEndOfDaySave ? Math.max(minuteTs, endOfDayTs) : minuteTs;
+                                    const historyLengthBeforeAdding = energyHistory.length;
 
                                     if (lastTs > 0) {
 
@@ -4413,6 +4414,33 @@ class EnvoyDevice extends EventEmitter {
 
                                     }
 
+                                    // Distribute interval spike evenly across preceding gap records
+                                    for (let i = historyLengthBeforeAdding; i < energyHistory.length; i++) {
+                                        const rec = energyHistory[i];
+                                        if (!rec || rec.pr === null) continue;
+
+                                        const gapIndices = [];
+                                        for (let j = i - 1; j >= 0 && energyHistory[j]?.pr === null; j--) {
+                                            gapIndices.unshift(j);
+                                        }
+
+                                        if (gapIndices.length === 0) continue;
+
+                                        const slots = gapIndices.length + 1;
+                                        const pritSlot = r3(rec.prit / slots);
+                                        const cnitSlot = r3(rec.cnit / slots);
+                                        const ctitSlot = r3(rec.ctit / slots);
+
+                                        for (const idx of gapIndices) {
+                                            energyHistory[idx].prit = pritSlot;
+                                            energyHistory[idx].cnit = cnitSlot;
+                                            energyHistory[idx].ctit = ctitSlot;
+                                        }
+                                        rec.prit = pritSlot;
+                                        rec.cnit = cnitSlot;
+                                        rec.ctit = ctitSlot;
+                                    }
+
                                     if (needsMinuteSave) this._lastSavedMinuteTs = minuteTs;
                                     if (needsEndOfDaySave) this._lastSavedEndOfDayDate = todayStr;