Upgrade Path

Home Assistant Core 2021.7.0 → 2021.8.0

5 versions, 34 breaking changes in 1 version, 0 required stops

Version by version, oldest first

2021.7.1 – 2021.7.4: no action items (4 versions)

2021.8.0 2021-08-04

Quoted from www.home-assistant.io/blog/2021/08/04/release-20218/#backward-incompatible-changes

Breaking

Abode

The previously deprecated YAML configuration of the Abode integration has been removed.

Abode is now configured via the UI, any existing YAML configuration has been imported in previous releases and can now be safely removed from your YAML configuration files.

(@frenck - #52357) (abode docs)

Breaking

AirVisual

The Air Quality platform has been marked as deprecated, therefore the air_quality entity has been removed and replaced with sensor entities.

If you used the air_quality entity in your automations, scripts or Lovelace dashboards, you'll need to update your configuration to match this change.

(@bachya - #52349) (airvisual docs)


States for the "Pollutant Level" and "Main Pollutant" entities have changed; automations that depended on the old states will need to be updated.

Pollutant Level:

  • Good -> good
  • Moderate -> moderate
  • Unhealthy -> unhealthy
  • Unhealthy for sensitive groups -> unhealthy_sensitive
  • Very unhealthy -> very_unhealthy
  • Hazardous -> hazardous

Pollutant Label:

  • Carbon Monoxide -> co
  • Nitrogen Dioxide -> n2
  • Ozone -> o3
  • PM10 -> p1
  • PM2.5 -> p2
  • Sulfur Dioxide -> s2

(@bachya - #53133) (airvisual docs)

Breaking

Ambient Weather Station

The previously deprecated YAML configuration of the Ambient Weather Station integration has been removed.

Ambient Weather Station is now configured via the UI, any existing YAML configuration has been imported in previous releases and can now be safely removed from your YAML configuration files.

(@bachya - #52459) (ambient_station docs)

Breaking

AVM FRITZ!Box Net Monitor / AVM FRITZ!Box Tools

In order to optimize device load and avoid exhausting available connections, fritz_netmonitor has been merged into fritz.

Please remove your YAML existing configuration and configure the new integration.

(@chemelli74 - #52264) (fritz docs)


The profile switches introduced in the previous release have been removed as they where incompatible with the Home Assistant architectural design rules.

Instead, you can now block every device connected individually.

(@AaronDavidSchneider - #52721) (fritz docs)

Breaking

AVM FRITZ!SmartHome

The power and energy attributes from switch entities have been removed and replaced by sensors.

If you relied on these attributes in your automations, scripts or Lovelace dashboards, you'll need to update your configuration to match this change.

(@mib1185 - #52562) (fritzbox docs)

Breaking

Bosch BME280

The YAML configuration for this integration has changed. Instead of a sensor config with platform section, an integration configuration section under the integration domain key should be used.

Before:

sensor:
  - platform: bme280
    name: "Stary_Oskol"

After:

bme280:
  - name: "Stary_Oskol"

(@Kuzj - #48775) (bme280 docs)

Breaking

Broadlink

The power and energy attributes from switch entities have been removed and replaced by sensors.

If you relied on these attributes in your automations, scripts or Lovelace dashboards, you'll need to update your configuration to match this change.

(@Danielhiversen - #53342) (broadlink docs)

Breaking

Buienradar

The previously deprecated YAML configuration of the Buienradar integration has been removed.

Buienradar is now configured via the UI, any existing YAML configuration has been imported in previous releases and can now be safely removed from your YAML configuration files.

(@frenck - #52939) (buienradar docs)

Breaking

CO2 Signal

The CO2 Signal integration migrated to configuration via the UI. Configuring CO2 Signal via YAML configuration has been deprecated and will be removed in a future Home Assistant release.

Your existing YAML configuration is automatically imported on upgrade to this release; and thus can be safely removed from your YAML configuration after upgrading.

(@Danielhiversen - #53193) (co2signal docs)

Breaking

Demo

Demo switch entity no longer reports current_power_w and today_energy_kwh attributes.

(@thecode - #52424) (demo docs)

Breaking

devolo Home Control

The consumptions attributes from the switch entities have been removed and replaced by sensors.

If you relied on these attributes in your automations, scripts or Lovelace dashboards, you'll need to update your configuration to match this change.

(@Shutgun - #53335) (devolo_home_control docs)

Breaking

GIOŚ

The Air Quality platform has been marked as deprecated, therefore the air_quality entity has been removed and replaced with sensor entities.

If you used the air_quality entity in your automations, scripts or Lovelace dashboards, you'll need to update your configuration to match this change.

(@bieniu - #52295) (gios docs)

Breaking

Google Assistant

Home Assistant will no longer expose the legacy fan speeds to Google Assistant.

If you use fans with with Google Assistant, you'll need to resync your device. Ask you Google device to Sync my device or trigger an update via the google_assistant.request_sync service.

(@elupus - #53105) (google_assistant docs)

Breaking

HomeKit

Previously the on/off switches provided to HomeKit by scripts, would enable or disable a script. This likely was not what is expected as Hey Siri turn on "script" would appear to do nothing.

Pressing a script switch in HomeKit now runs the script instead.

(@bdraco - #53106) (homekit docs)

Breaking

HomeKit Controller

HomeKit Controller was using the wrong ID to track some sensors. The following are affected:

  • Koogeek or Eve power sensors (added in Jan 2021)
  • The temperature sensor added alongside homekit climate devices (added in Jul 2021, the climate entity itself is not affected)

If you have one of these you may need to remove a stale entity registry entry and you may need to fix the names of these entities as customizations may be lost.

(@Jc2k - #53848) (homekit_controller docs)


If you have a power sensor for a Eve Energy or Koogeek P1EU/SW2, the units for that sensor has changed from watts to W to properly follow Home Assistant standards.

(@Jc2k - #53877) (homekit_controller docs)

Breaking

Honeywell Total Connect Comfort (US)

The Honeywell integration migrated to configuration via the UI. Configuring Honeywell via YAML configuration has been deprecated and will be removed in a future Home Assistant release.

Your existing YAML configuration is automatically imported on upgrade to this release; and thus can be safely removed from your YAML configuration after upgrading.

(@rdfurman - #50731) (honeywell docs)

Breaking

Huawei LTE

Routers currently in unauthenticated mode need to be provided credentials for duration of one successful startup in order to retrieve a unique id from the API. Unauthenticated mode can then be enabled for subsequent starts in integration options.

(@scop - #49878) (huawei_lte docs)

Breaking

Itho Daalderop Spider

The power and energy attributes from switch entities have been removed and replaced by sensors.

If you relied on these attributes in your automations, scripts or Lovelace dashboards, you'll need to update your configuration to match this change.

(@peternijssen - #53397) (spider docs)

Breaking

Jewish Calendar

The Jewish Calendar integration returned a datetime format that wasn't properly formatted according to ISO standards. This has been adjusted.

If you rely on manually parsing of dates that are returned from this integration, you might need to adjust your templates to incorporate this change.

(@frenck - #52722) (jewish_calendar docs)

Breaking

Lyft

The Lyft integration has been deprecated and is pending removal in Home Assistant Core 2021.10.0. It is considered impossible to obtain API keys to be able to use this integration.

(@frenck - #53005) (lyft docs)

Breaking

Mill

The consumption_today and consumption_total from the climate entity have been removed and replace by sensors.

If you relied on these attributes in your automations, scripts or Lovelace dashboards, you'll need to update your configuration to match this change.

(@Danielhiversen - #52311) (mill docs)

Breaking

Modbus

All entities are set to unavailable during loading of modbus integration and remain so until data is received. Entities with scan_interval = 0 (entities without polling) are always available, to allow service calls.

The old configuration style with setting scan_interval: 9999 will cause the entity to be unavailable for 9999 seconds.

(@janiversen - #53155) (modbus docs)

Breaking

MySensors

The power and energy attributes from switch entities have been removed.

If you relied on these switch attributes in your automations, scripts or Lovelace dashboards, you'll need to update your configuration to match this change.

This measurement (S_POWER, V_WATT) will still be reported as previously by the power sensor entity.

(@MartinHjelmare - #53566) (mysensors docs)

Breaking

Prometheus

This includes a few changes to the names of the exported Prometheus metrics, which now better align with Prometheus naming guidelines:

  • Default value for the namespace configuration variable is now homeassistant, and all metric names now have a default homeassistant_ prefix.
  • Some metrics have been renamed:
  • light_state renamed to light_brightness_percent.
  • temperature_c renamed to climate_target_temperature_celsius.
  • current_temperature_c renamed to climate_current_temperature_celsius.
  • Sensor metrics now have a sensor_ name prefix.
  • Temperature sensor metrics now have a _celsius unit suffix (as opposed to just _c).

Note, that users that don't currently explicitly set the namespace variable will see names changed for all exported metrics. If keeping existing metric names is important to you, you can adjust your Home Assistant and Prometheus configuration as described below.

To keep metrics exported without the homeassistant_ prefix, explicitly set an empty namespace in Home Assistant configuration:

prometheus:
  namespace: ""

To revert the other metric name changes, you can use metric_relabel_configs in your Prometheus configuration file to rename the metrics after scraping. This set of relabeling rules is a good starting point, but please note that if you set a non-empty namespace in Home Assistant you will need to adjust these rules accordingly.

(@knyar - #50156) (prometheus docs)

Breaking

Rituals Perfume Genie

The previously deprecated fan speed and room size attributes have been removed. They have now have got their own entities.

(@milanmeu - #53611) (rituals_perfume_genie docs)

Breaking

Synology DSM

The previously deprecated YAML configuration of the Synology DSM integration has been removed.

Synology DSM is now configured via the UI, any existing YAML configuration has been imported in previous releases and can now be safely removed from your YAML configuration files.

(@mib1185 - #53197) (synology_dsm docs)

Breaking

Tibber

The previously deprecated YAML configuration of the Tibber integration has been removed.

Tibber is now configured via the UI, any existing YAML configuration has been imported in previous releases and can now be safely removed from your YAML configuration files.

(@Danielhiversen - #53235) (tibber docs)

Breaking

TP-Link Kasa Smart

The power and energy attributes from switch entities have been removed and replaced by sensors. This applies to all five extra attributes about energy (current_power_w, total_energy_kwh, today_energy_kwh, voltage, current_a).

If you relied on these attributes in your automations, scripts or Lovelace dashboards, you'll need to update your configuration to match this change.

(@mib1185 - #53596) (tplink docs)

Breaking

VeSync

The previously deprecated YAML configuration of the VeSync integration has been removed.

VeSync is now configured via the UI, any existing YAML configuration has been imported in previous releases and can now be safely removed from your YAML configuration files.

(@frenck - #52358) (vesync docs)

Breaking

Viessmann ViCare

Viessmann introduced a new API to control their devices. The original (inofficial API) was shut down which rendered the Home Assistant integration useless. This breaking change restores the integrations functionality

This involves adding a new client_id parameter. It must be set with an API key from the Viessmann developer portal.

Please register and create your private API key. Follow these steps to create your API key:

  1. Register and login in the Viessmann Developer Portal.
  2. In the menu navigate to API Keys.
  3. Create a new OAuth client using following data:
  Name: PyViCare
  Google reCAPTCHA: Disabled
  Redirect URIs: vicare://oauth-callback/everest
  1. Copy the Client ID to the configuration, e.g. client_id="XXXXXXXXXXXXXX"
  vicare:
    username: VICARE_EMAIL
    password: VICARE_PASSWORD
    client_id: VICARE_CLIENT_ID

Please not that not all previous properties are available in the new API. Missing properties were removed and might be added later if they are available again.

(@oischinger - #53281) (vicare docs)

Breaking

WLED

The wled.preset service has been deprecated. In the previous Home Assistant release, support for an select entity that provides access to presets has been added, use that entity in your automations and scripts instead.

(@frenck - #53383) (wled docs)


The playlist attribute from the WLED light entities has been removed and replaced by a playlist select entity instead of the attribute.

If you relied on the attribute in your automation or scripts, you need to adjust those to use the new entity instead.

(@frenck - #53381) (wled docs)

Breaking

Xiaomi Miio

Existing Xiaomi Mi automations using the platform specific services for humidifiers will have a breaking change. You need to change their automation to use new services. Existing fan entities will be automatically replaced with new humidity entities.

The entity name is migrated from the fan entity name. The fan entity_id will change because the platform will change.

For the related entities the old fan entity name will be prepended to the new entities.

Example:

Entity with entity_id "fan.my_device" and name "My humidifier" will migrate to an entity with entity_id "humidifier.my_humidifier" and name "My humidifier".

A sensor for humidity will have a name like "My humidifier Humidity".

(@jbouwh - #52366) (xiaomi_miio docs)

Breaking

Yale Smart Living

The CYale Smart Living integration migrated to configuration via the UI. Configuring Yale Smart Living via YAML configuration has been deprecated and will be removed in a future Home Assistant release.

Your existing YAML configuration is automatically imported on upgrade to this release; and thus can be safely removed from your YAML configuration after upgrading.

(@gjohansson-ST - #50850) (yale_smart_alarm docs)

Breaking

Z-Wave JS

Z-Wave JS entities will now be in an unavailable state when the parent node is considered dead by Z-Wave JS. This may impact existing automations because Home Assistant will block service calls to unavailable entities.

A node can potentially be revived by sending a ping to it, therefore you can use the new node status sensor (disabled by default) to track node status and use the zwave_js.ping_node service to try to revive the node.

The node status sensor will always be available even when the node is dead.

(@raman325 - #48017) (zwave_js docs)

Note

Farewell to the following

The following integrations are no longer available as of this release:

  • Weather Underground has been unavailable and in a non-working state and has therefore been removed. (@frenck - #52999)
  • Garmin Connect has been removed. Due to API changes, it stopped working and cannot function without violating Home Assistant design rules. Garmin will not allow open source projects to their official APIs. (@cyberjunky - #52808) (garmin_connect docs)

From www.home-assistant.io/blog/2021/08/04/release-20218/#farewell-to-the-following

Full release notes for 2021.8.0

Release notes from github.com/home-assistant/core/releases, and the official release blog, checked 18 hours ago. Only text the vendor marks as breaking, or puts in a warning/caution/important note, is shown; read the full notes for anything else. Home Assistant lists its breaking changes in the “Backward-incompatible changes” section of each monthly release post on home-assistant.io (2020.12 onward). Each entry of that section is quoted as “Breaking” on the x.y.0 release, under the integration name the post gives it. The post’s “Farewell to the following” section (integrations removed in that release, 2020.12–2024.5) is quoted whole as “Note”. The post's separate section for custom integration developers is not quoted. Patch releases are listed but their notes (lists of fixes) are not quoted. Versions come from PyPI (package homeassistant).