General improvements
- fix problem with entity migration in 2023.8.0 #984
Due to the short time between 2023.8.0 and 2023.8.1, and the likelihood the previous release has been skipped, the breaking changes section for 2023.8.0 is repeated below. For more details on the other changes, see the release notes for 2023.8.0.
Breaking changes in 2023.8.0
Default naming
Many sensors are now defaulting to the HA standard name for their class, to make use of standard name translations. This has resulted in some entities being renamed. A migration attempts to handle the renaming in Home Assistant's registry but it may still be necessary to update automations or some other references to entities. There may also be some cases that were missed by the migration, in which case you will have new entities created, and the old ones will become "unavailable" and will need to be deleted manually.
If you are using a version of Home Assistant older than 2023.7, some entities will be displaying only the device name the UI. #871
These are the main changes:
- carbon_dioxide: some were previously named CO2
- carbon_monoxide: some were previously named CO
- humidity: some were previously named Current humidity, but no change was made for deprecated sensors (see below)
- pm1: some were previously named PM 1.0 (translates to pm_1_0 in entity naming)
- pm10: some were previously named PM 10 (translates to pm_10 in entity naming)
- pm25: were previously named PM 2.5 (translates to pm_2_5 in entity naming)
- temperature: some were previously named Current temperature
- volatile_organic_compounds some were previously named TVOC
Humidity sensor deprecation for humidifiers and dehumidifiers
Current humidity sensors for humidifiers and dehumidifiers have been deprecated, as the humidifier entity supports reporting of current humidity as of HA 2023.7 #869
Battery level moved to separate sensor for vacuums
As of HA 2023.8, the battery_level attribute of vacuums is deprecated, to be replaced by battery sensors. To avoid the deprecation warning, this change has been made already. After this change, battery status has full history recording available, however if you have any automations reading the battery_level from the vacuum, you will need to update these to read from the battery sensor instead.
Some custom cards may not yet be updated for this change, so the battery level may disappear from the card until it is updated. #954
Poolex Q7 (and Q9 and others) use as water_heater is deprecated
After gathering more info on the preset modes available for this device, the main entity has been changed from water_heater to climate to make the cooling funtions available too. The water_heater entity is deprecated. #966
hidden mappings behaviour change
Previously a mapping could be marked hidden to hide it from the list of possible values. Now these mappings have also been made one-way, to only map device values to the UI. The main use case for these is to map unexpected values like null (missing any value) to something else for the UI. Mapping back to these unexpected values when a value is changed from the UI is not desirable behaviour for the use cases imagined for this feature, and if you need that the mapping should probably not be hidden. #914