What's new

Config flow wizard with mDNS/zeroconf discovery

A multi-step setup wizard replaces the old manual configuration. ESPHome proxies are discovered automatically via mDNS — just select yours from the dropdown. Manual IP entry is always available as a fallback on the same screen, with a rescan button if discovery finds nothing on the first attempt.

Model-specific entity sets

Entities are now registered based on what your device actually supports. Connecting a Mera Classic no longer creates orientation-light or seat-heater entities; connecting an AquaClean Alba creates the full set of Alba-specific sensors (spray arm, descaling, DpId coverage, etc.) while hiding Mera-only entities like SOC Versions.

Upgrade note: existing installations must delete and recreate the config entry to pick up model-specific entities. See the upgrade guide for steps.

Other improvements

• Entities register immediately on setup — HA shows the "Name and assign" dialog without waiting for a successful BLE poll (lazy init)
• Alba DpId Coverage sensor correctly reports 47/79 wired DpIds (DpIds 564 and 607 were missing from the wired set)
• SOC Versions sensor no longer appears on Alba devices

• Lazy init: entities register immediately; 'Name and assign' dialog shows without waiting for BLE poll
• DpId Coverage: now reports 47/79 (DpIds 564 and 607 added — both wired via fast SPL poll into binary sensors)
• SOC Versions sensor hidden for Alba (FS_AQUACLEAN_OLD only; was incorrectly FS_ALL)

• Fix: DpId Coverage sensor permanently showing "Unknown" — when device_type="alba" was already stored in the config entry, the coordinator skipped the inventory assignment on every restart; now populated from client._inventory on first successful connect

• Config flow: "Retry proxy scan" checkbox — check + Submit re-runs mDNS discovery and refreshes the proxy dropdown without leaving the step
• Alba DpId Coverage sensor now enabled by default (was disabled)

• Config flow: proxy dropdown and manual IP/port fields shown simultaneously — no longer need mDNS to succeed to enter an IP manually
• mDNS scan timeout raised 8 → 12 s for better reliability on slow networks

What's new since v3.1.2b1

Alba: DpId Coverage diagnostic sensor

A new diagnostic sensor — DpId Coverage — is added for Alba devices. It is disabled by default and visible in the Diagnostics tile.

• State: "N / M wired" — how many of the device's inventory DpIds have wired HA entities
• Attributes: one entry per DpId in the live DataPointInventory, each showing its name and whether it is wired

The sensor is dynamic: any DpId exposed by a future firmware update automatically appears after the next HA restart. ALBA_WIRED_DPIDS in const.py is the single source of truth — it will be updated as new Alba entities are added.

Missing wired=False stubs added (ProfileSetting + CommonSetting)

Three additional stub entities (disabled by default) are now registered for features confirmed in the protocol spec but not yet exposed by the bridge:

• Seat Heating (ProfileSetting 11, Tuma Comfort only)
• Odour Extraction Run-On (CommonSetting 5)
• Care Mode (CommonSetting 11, Mera Floorstanding only)

⚠️ Delete-and-recreate still required (from v3.1.2b1)

See v3.1.2b1 release notes for the one-time migration note.

What's new

Model-specific entity sets

Only entities supported by your device model are now registered. Unsupported entities (e.g. orientation light controls on a Mera Classic) are created as disabled stubs that surface a clear error if triggered — they no longer clutter the entity registry.

Detection happens automatically:

• Config flow (wizard): model detected from BLE advertisement during setup
• Manual MAC entry: model detected via proc 0x82 on first poll and persisted to the config entry; correct entity set applied from the second HA restart onwards

⚠️ Delete-and-recreate required (one-time migration)

Upgrading from v3.1.1 or earlier requires a delete-and-recreate of the integration to remove orphaned entities from the old full-entity registration:

1. Settings → Devices & Services → Geberit AquaClean → ⋮ → Delete
2. Add the integration again and complete the setup wizard
3. Only entities supported by your device are registered from this point on

See docs/hacs-integration.md — Updating for full details.

Supported models

Mera Comfort · Mera Classic · Sela · Alba / Alba kstr

• Device type now shows full brand name: "Geberit Mera Comfort", "Geberit Alba", "Geberit Sela", etc.

• Fix: Mera Comfort now shows article prefix "146.21" and model "Mera Comfort" in BLE selector (was showing adv_name and generic "AquaClean")
• Root cause: AquacleanOld devices use manufacturer company ID 0x0100 (not 0x0602), article at payload bytes 1-5 (not 3-7)
• Confirm Setup: transport now shows proxy name + host:port + auto-discovered vs manual
• Confirm Setup: device line now shows full label from scan (article + MAC + model)

• Add debug logging in BLE scan label builder (adv_bytes hex, pre-stored keys, parse result)