Repository navigation
v1.24.0
🌟 What's new in v1.24.0?
Your numbers are now complete and fair, and every dashboard card got a make-over. This is a big release: please update the integration and re-paste your cards (see After updating). No breaking changes to entities or automations.
🔥 What it means for your heat pump
| You now get | Why it matters |
|---|---|
| Every minute of runtime counted — a heat pump that runs all day shows close to 24 hours | A Home Assistant restart during a run used to drop the part before the restart (up to 11 hours a day on a 24/7 system). Runs lost earlier are rebuilt once from the stored COP measurements (#417, #419) |
| A fair quality score — each penalty grows with how far a run is from good | A 2-minute backup-heater blip no longer costs as much as 30 minutes of backup heater. All your stored cycles are rescored once (#421) |
| Correct "short pause" detection and learned thresholds | The pause before a run included the run itself, so Short off almost never fired (#415) |
| No false short runs when the heat pump switches between heating and hot water | The compressor keeps running; it is now one run, not a stop and a start (#419) |
| Cleaner COP | The old 16.5 outlier is gone from the month COP; COP below datasheet no longer fires at start-up; heating-curve advice compares readings from the same moment (#415) |
| Correct ΔT with the backup heater on | ΔT is now measured before the backup heater, so its heat no longer inflates your ΔT (#423) |
| Heating-curve advice stays visible during hot water | The advice pauses while the tank heats, but your measured curve stays on the cards (#427) |
| ESPAltherma v2 aligned with its own name catalog | Values of exactly 0 or 1 are no longer lost; cooling is recognised without a hot-water tank and for "Auto Cool" (#413, #423) |
⭐ The new quality score
Every closed run starts at 100. Each criterion subtracts points in proportion to how far the run is from good, up to a maximum. The Last cycle sensor shows what each criterion cost (attribute quality_penalties).
| Criterion | Max points | How it is counted now | Example | Before v1.24.0 |
|---|---|---|---|---|
| ⏱️ Short run | 30 | 30 × shortfall to the good run length | good run 45 min: a 40 min run → 3.3, a 10 min run → 23.3 | 30 for any run under the threshold |
| 🌡️ Low ΔT | 20 | 20 × shortfall to the good ΔT | good ΔT 5 K: 4 K → 4, 2.5 K → 10 | 20 |
| ⏸️ Short pause | 20 | 20 × shortfall to the good pause | good pause 20 min: 15 min → 5, 2 min → 18 | 20 |
| 🔁 Many short runs today | 20 | 0 up to half the threshold, then rising to 20 at 1.5 × the threshold | threshold 50 %: 25 % → 0, 50 % → 10, 75 % → 20 | 20 |
| ⚡ Backup heater | 20 | 1 point per % of the run time (step 2 counts double) | 2 of 300 min → 0.7, 8 of 300 min → 2.7, 30 of 300 min → 10 | 10, however short |
| ❄️ Defrost | 10 | 1 point per % of the run time above 5 % (normal defrosting is free) | 6 of 300 min → 0, 30 of 300 min → 5 | not counted |
Not penalised: a run that continues after a heating ↔ hot-water switch, a run that is still going (Quality today waits until it ends), backup heater during a legionella cycle, and missing data. The thresholds are your own options (good run, good ΔT, good pause). Full explanation: Quality score.
Expect your scores to change: most long runs score higher, very short runs with backup heater lower. That is the new formula, not a fault.
🎨 Dashboard cards: update them too
All seven cards were checked against the data the integration really writes, in English, Dutch and French, and unified (#427):
- Your heat pump model in every header — title + model, family, power and refrigerant.
- Dark mode — follows the Home Assistant dark mode; every card stays readable.
- One set of options on every card —
lang_override(en / nl / fr),theme_override(auto / light / dark),show_help, in the card header. Before this release these options never reached the cards; now they work. - Your language everywhere — English, Dutch, French; numbers in your own format (5.27 or 5,27).
- Fixes you will see:
- Simple card: ΔT of the last cycle now shows (it was always "—"); Q is the real quality score.
- Summary: no longer always Dutch; real defrost events per day.
- Pattern analysis: the tab you tap is the tab you see.
- Heating curve: clean points with a tooltip, a blinking live point, and the curve stays visible during hot water.
- LWT fine-tuning: keeps your tab and pop-up when it refreshes; blue = lower, green = optimal, red = raise.
- No longer needed: mushroom-template-card (stack-in-card, button-card and card-mod are enough).
| Card | YAML | Docs | Changelog |
|---|---|---|---|
| Simple card | simple-card.yaml | README | CHANGELOG |
| COP & energy | cop-energy.yaml | README | CHANGELOG |
| Summary | daily-summary.yaml | README | CHANGELOG |
| Daily summary (tabbed) | daily-summary-tabbed.yaml | README | CHANGELOG |
| Heating curve | heating-curve.yaml | README | CHANGELOG |
| LWT fine-tuning | card.yaml | README | CHANGELOG |
| Pattern analysis | pattern-analysis.yaml | README | CHANGELOG |
Settings shared by all cards (header, language, dark mode, variables): Shared card settings.
✅ After updating
- Update the integration: HACS → Daikin Cycle ML → Update, then restart Home Assistant. The first start runs a one-time clean-up: it rebuilds lost runs, rescores all cycles and recalculates the daily summaries. That start can take a little longer than usual.
- Re-paste every card you use (links in the table above): Edit dashboard → card → ⋮ → Edit in YAML, replace everything with the new YAML, Save. The old cards keep working but miss the fixes, the model header and dark mode.
- (Optional) Set your preferences in the card header's
variables:—lang_override,theme_override,show_help. Cards now follow your Home Assistant UI language first; setlang_override: nl(orfr) if you want the integration language instead. The COP & energy card now follows the HA dark mode by default (theme_override: lightkeeps the old look). - (Optional) Remove mushroom if no other card of yours uses it.
- Check: Download diagnostics →
coordinator.runtime_check.coverage_pctshould be close to 100 % if your heat pump runs all day.
🙏 Thank you
- Tweakers forum users for the reports on cards, tabs, pop-ups and colours (the LWT card colour advice came from you), and on COP. The alerts-card request is #425.
- ESPAltherma, for
data/catalog_names.txt, which v2 support is now checked against.
Found something? Open an issue and attach your diagnostics.
📚 Manuals: Documentation index · Quality score · Configuration · Entities · Alerts · Troubleshooting · Database & migrations · Model compatibility · Dashboard cards
🛠️ Technical Details & Fixes
Added:
- #413 v2 catalog:
docs/ESPALTHERMA_V2_CATALOG.json(beta 3548ea2) andtools/parse_espaltherma_catalog.py; the PR gate regenerates the snapshot at its pin, the weekly drift issue lists removed v2 names; I/U and O/U side-name fallback. PR #414. - #419 diagnostics
coordinator.runtime_check; migration v32 rebuilds runs lost on a restart fromcop_samples(is_reconstructed = 1). PR #420. - #427
daily_summary_recent.events_by_dayexposed (built since #400, never published);docs/README.mddocumentation index;dashboard/cards/README.mdshared card settings; per-card CHANGELOG.md;tools/card_common.js+tools/sync_card_common.py(shared language / theme / header block, drift-checked). PR #428.
Changed:
- #421 Proportional quality penalties: short run, ΔT and pause scale with the shortfall; ratio from half the threshold; BUH 1 point per % (step 2 double, max 20); defrost 1 point per % above 5 % (max 10);
quality_penaltiesbreakdown; one-time rescore and re-roll. PR #422. - #423
learned_thresholdsstate = the value in use; DEBUG logs only on change. PR #424. - #427 cards: button-card header with the model on every card (mushroom removed), header
variables: &dcmreused by every button-card (*dcm), language rule override → HA language →configured_language→ en, one palette with dark mode, decimal separator from the HA number format. PR #428.
Fixes:
- #415 PR #416:
off_s= start − previous end; v31 rebuilds stalecop_hourlyrows (read guard); heating-curve tracking and A7/W35 normalisation from live R1T;cop_vs_datasheet_lowon a steady 1-hour mean; weighted p10/p90. - #417 PR #418: detector restored before the first tick; persisted on split and every 15 min; resume gap measured as downtime.
- #419 PR #420:
ended_by/continued(split and cap segments); the live score doesn't judge a running cycle. - #423 PR #424: numeric attributes read "0"/"1" as numbers; ΔT and the curve LWT from R1T; accumulator write bounded at 2 s.
- #413 PR #414: cooling for installations without DHW and for "Auto/Storage" modes.
- #427 PR #428: heating-curve advice keeps the measured buckets / LWT during DHW and BUH (
suppressed_byalso for DHW); simple-card ΔT (dt_avg_k) and Q score; daily-summary language; pattern-analysis click handling per card; LWT card keeps tab / pop-up over re-renders.
Tests: 6,984 tests, 100 % coverage; new suites reproduce the prod-1 v1.23.3 diagnostics, SQL and log, and render every card in EN / NL / FR and dark mode from a fixture of the real integration after ~38 h of simulated operation.
Changelog: CHANGELOG.md | Compare v1.23.3...v1.24.0
☕ 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:
