This is a beta pre-release ahead of v0.24.0, cut specifically to get the config-entry migration below in front of real installs before it goes out to everyone. Please try it and open an issue with a fresh diagnostics dump if your devices don't come back the way you'd expect — especially composite (multi-subdevice) appliances and anything on a placeholder/shared serial number (issues #83, #189, #381).
To install: in HACS, open LocalThings → the three-dot menu → Redownload, then enable Show beta versions and pick 0.24.0-beta.1.
⚠️ Breaking: config entries move to v4
Two Samsung air purifiers of the same model were confirmed reporting the identical, well-formed serial number BS7SP9AW400114A — since every entity, the device, and the entry itself were keyed from that string, the second unit was refused as already configured. Identity now resolves /oic/d's di → /oic/p's pi → the serial → the host, in that order, since di is what the protocol already uses to address the device and can't be shared across units the way a serial can.
The re-key can't happen at migration time — the UUID is only readable from a live device, and an entry can load entirely from its offline snapshot. So the v3 → v4 migration itself is a no-op beyond recording your current key; the coordinator adopts the new UUID on the first successful poll after upgrading, rewriting your entity registry, device registry, and the entry's identity together so entity IDs, names, areas, statistics, and automations all survive intact. A board that doesn't answer either OCF resource is unaffected and keeps working exactly as before.
Once an entry has migrated to v4, it can't be loaded by an older release — a downgrade guard fails the entry rather than risk silently orphaning its entities. Back up your config if you might need to roll back before this reaches stable. (#383, closes #381)
✨ Added
- Dishwashers get the Drum Clean+ maintenance sensors (
drum_clean_cycles_remaining,drum_clean_last_cleaned) that washers and dryers already report — the shared reader was there, dishwashers just weren't wired into it. (#386)