jeans/developers.home-assistant
jeans/developers.home-assistant
1
0
Fork 0
mirror of https://github.com/home-assistant/developers.home-assistant.git synced 2025-07-19 07:16:29 +00:00
Code Issues Packages Projects Releases Wiki Activity

Blog post on MQTT entity naming changes (#1851)

Browse Source
This commit is contained in:
Jan Bouwhuis 2023-07-21 12:52:32 +02:00 committed by GitHub
parent 659a4fc9f5
commit 9757230c5d
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 20 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
blog/2023-057-21-change-naming-mqtt-entities.md Normal file
View File

@ -0,0 +1,20 @@
---
author: Jan Bouwhuis
authorURL: https://twitter.com/jbouwh
title: The naming of MQTT entities changes to correspond with HA guidelines
---
The way MQTT entities are named and how device configuration can be shared between discovered entities has changed
### Sharing of device configuration
Discovered MQTT entities can share device configuration, meaning one entity can include the full device configuration and other entities can link to that device by only setting mandatory fields.
The mandatory fields were previously limited to at least one of `connection` and `identifiers`, but has now been extended to at least one of `connection` and `identifiers` as well as the `name`.
### Naming of MQTT entities
Naming of MQTT entities has been changed to be aligned with the [entity naming guidelines](https://developers.home-assistant.io/docs/core/entity/#entity-naming):
- The `has_entity_name` entity will be set to `True` on all MQTT entities
- Unnamed `binary_sensor`, `button`, `number` and `sensor` entities will now be named by their device class instead of being named `MQTT binary sensor" etc.
- It's now allowed to set an MQTT entity's name to `None` to mark it as the main feature of a device