2026.08.29 — last release for Home Assistant ≤ 2026.7

🏠 Home Assistant compatibility

This is the last release that supports Home Assistant 2026.7 and older. The next release will require Home Assistant 2026.8 or newer.

Home Assistant 2026.8 replaced the via_device device-registry link with via_device_id, and 2026.9 removed the old key from its typing altogether. Supporting both at the same time would mean carrying a code path that can never be exercised by the test suite, so the integration moves to the new API in the next release instead.

• On Home Assistant 2026.8 or newer — nothing to do, updates continue as usual.
• On Home Assistant 2026.7 or older — this release keeps working. HACS will simply keep you on it and stop offering updates until you upgrade Home Assistant.
• On the Home Assistant 2026.9 beta — you may see up to ten warnings per restart reading Detected that custom integration 'luxtronik2' calls device_registry.async_get_or_create with a deprecated via_device parameter. Nothing stops working, and the message's suggestion to open a bug report can be ignored: it is already known and fixed in the next release.

⚠️ Note for release notes (#762)

Renaming 1135 removes Unknown_Parameter_1135 as a luxtronik2.write target. Same precedent as 1138 in #754; realistically nobody writes to a counter.

⚠️ Upgrade notes (#771)

Two entities change in this release. Home Assistant cannot rewrite either for you, so anything referring to them by name needs updating by hand — YAML automations and scripts, dashboard cards, template sensors and helpers.

The Smart Grid switch becomes a select.

Removed	switch.<prefix>_smartgrid
Replaces it	select.<prefix>_smart_grid_mode

The old switch is removed from the entity registry automatically on upgrade; you do not need to delete it. Anything calling switch.turn_on / switch.turn_off on it must move to select.select_option with one of off, plus_minus, sg_1_0, sg_1_1.

Worth knowing why: the switch could only express on/off, but the underlying setting holds a mode. Toggling it off and on rewrote the mode to +/-, silently changing which Smart Grid variant your controller ran. If you ever toggled that switch, check Service → Einstellungen → System Einstellung → Smart Grid on the controller and set it back to the variant your installation is wired for.

The heating circuit control mode reports names instead of digits.

select.<prefix>_heating_control_circuit_mode reported 0, 1 and 2; it now reports heating_curve_control, fixed_temperature and analog_in. The displayed names in the UI are unchanged. Automations comparing the old digits, or passing one to select.select_option, must use the new values. This entity is disabled by default, so most installations never had it.

Smart Grid status may read differently — correctly — on SG 1.0 and SG 1.1. If your controller runs one of those two variants, the Smart Grid status sensor previously reported the wrong state for some contact positions, and can now report two new ones: power_limitation and start_command. Installations on +/- (the common case) are unaffected and keep the four states they had.

⚠️ Upgrade notes (#777)

If you run Smart Grid and installed 2026.08.27 or 2026.08.28, your number entities (hot water hysteresis, heating curves, Smart Grid offsets) will have vanished from Home Assistant. They come back by themselves on this release — no manual step, nothing to re-add. Any automation or dashboard card that referenced them starts working again as soon as the entities return.

What's Changed

• feat(sensor,const,lux_overrides): ✨ expose the cooling heat quantity counter by @rhammen in #762
• fix(lux_helper,coordinator): 🐛 always flush the write queue, even when the write fails by @rhammen in #763
• fix(lux_helper): 🐛 wait only briefly for a write acknowledgement by @rhammen in #764
• feat(number): ✨ expose smart grid temperature offsets by @rhammen in #766
• docs(timer-schedules): 📝 document what the schedule times mean by @rhammen in #767
• fix(number): 🐛 gate DHW and cooling entities on the firmware minor by @rhammen in #768
• fix(common,const): 🐛 stop inverting the smartgrid evu1 input on 2.0 wiring by @rhammen in #769
• ci(release): 👷 carry the upgrade notes from merged PRs into the release by @rhammen in #772
• feat(sensor,select,lux_overrides): ✨ read the SmartGrid mode and its own state table by @rhammen in #771
• test(requirements): ✅ declare voluptuous-serialize for the test run by @rhammen in #776
• fix(common): 🐛 stop a single flow-rate dropout from clearing cooling by @rhammen in #775
• fix(coordinator): 🐛 stop a decoded visibility register from killing a platform by @rhammen in #777

Full Changelog: 2026.08.18...2026.08.29