Repository navigation
v1.23.3
🌟 What's new in v1.23.3?
More accurate COP and backup-heater numbers, and alerts that fire when they should. No breaking changes.
- Backup heater on its own power meter? New optional BUH power sensor (Configure → Device → Sensors). Its power is added to your heat pump meter, so COP no longer reads too high while the backup heater runs.
- No more false "Backup heater excessive" alerts. The alert now compares backup-heater minutes with compressor minutes. Before, one long run with a few minutes of backup heater counted as a full "backup heater day".
- Native ESPAltherma counters are kept when the integration switches to the ESPAltherma v2 entities (compressor runtime, defrosts, backup heater and starts no longer fall back to estimates).
- "COP vs datasheet" works again with the ESPAltherma v2 entities (it stayed empty) (#388).
- "Short run" alerts work with adaptive thresholds. If many of your runs are short, the learned threshold could drop to 2 minutes and the alert never fired. It now never goes below half of your own setting (#408).
- Cleaner COP history. Old impossible COP readings (stored before the COP checks existed) are cleaned up once, so week/month COP no longer shows values like 0.47 or 16.5 (#408).
- Your own COP sensor, checked. Diagnostics now compare the COP in use with the integration's measurement and ESPAltherma's estimate, so a template COP sensor that reads high is easy to spot (#408).
✅ After updating
- Update via HACS → Daikin Cycle ML → Update, then restart Home Assistant. The first start runs a one-time clean-up of old COP data and daily summaries (a few seconds).
- Backup heater on a separate meter? Configure → Device → Sensors → BUH power sensor → pick that meter.
- Using your own COP template sensor? Consider clearing COP sensor: the integration's own COP (your power meter + ESPAltherma heat, from one snapshot) is usually more accurate. Compare first in Download diagnostics →
cop_cross_check. - No card changes needed.
Found something? Open an issue and attach your diagnostics.
📚 Docs: Configuration — sensors · Alerts — buh_excessive · ML — adaptive thresholds
🛠️ Technical Details & Fixes
Added:
- BUH power sensor -
buh_power_sensor_entity(options Device → Sensors, EN/NL/FR); added topower_sensor_entityin_power_from_meter(W/kW normalised, invalid/idle ignored); compressor detection unchanged; attributesbuh_power_sensor,buh_meter_w. PR #410. - COP cross-check - diagnostics
coordinator.cop_cross_check(used / flow × ΔT ÷ power / ESPAltherma estimate / deviation %). PR #409.
Fixes:
- AUTO source tie - when v2 wins a 12/12 tie (rule unchanged) the monolithic sensor's extra attributes are merged in (individual wins per key);
source_resolution.supplemented_from_mono. PR #407. - #388 Datasheet normalisation - outdoor temperature via the alias layer (
Outdoor air temp.(R1T)/R1T-Outdoor air temp.);last_recordonly exists on the closing tick. PR #407. - buh_excessive - ratio = BUH minutes (
runtime_acc.<day>) / compressor minutes (daily_summary) over 7 d, as documented; cycle ratio kept as fallback (prod-1: 0.444 → 0.011). PR #407. - #408 Diagnostics follow-ups - effective short-run threshold ≥ half the configured value; migration v30 flags pre-gate COP samples (>
MAX_COP, heating/DHW <COP_FLOOR) and rebuilds/deletes theircop_hourlyhours;daily_summary.duration_min= within-day portion (≤duration_max), all days re-rolled once. PR #409.
Tests: 6,774 tests, 100% coverage; new suites reproduce prod-1 v1.23.2 diagnostics (AUTO tie, normalisation without last_record, BUH ratio), the learned-threshold collapse, the v30 migration on a real database, and the BUH power sensor.
Changelog: CHANGELOG.md | Compare v1.23.2...v1.23.3
☕ Support
Daikin Cycle ML is free, local-only, and open-source. If it has helped you optimize your heat pump or save on energy costs:
