Skip to content

v1.24.0

Choose a tag to compare

@elRadix elRadix released this 19 Nov 12:16
· 16 commits to main since this release
177ae8e
Daikin Cycle ML


GitHub stars

If this project helps you, a ⭐ star means a lot — it helps others discover it.


🌟 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

  1. 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.
  2. 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.
  3. (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; set lang_override: nl (or fr) if you want the integration language instead. The COP & energy card now follows the HA dark mode by default (theme_override: light keeps the old look).
  4. (Optional) Remove mushroom if no other card of yours uses it.
  5. Check: Download diagnostics → coordinator.runtime_check.coverage_pct should 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) and tools/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 from cop_samples (is_reconstructed = 1). PR #420.
  • #427 daily_summary_recent.events_by_day exposed (built since #400, never published); docs/README.md documentation index; dashboard/cards/README.md shared 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_penalties breakdown; one-time rescore and re-roll. PR #422.
  • #423 learned_thresholds state = 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: &dcm reused 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 stale cop_hourly rows (read guard); heating-curve tracking and A7/W35 normalisation from live R1T; cop_vs_datasheet_low on 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_by also 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: