Add known limitations section to ESPHome (#38618)

This commit is contained in:
J. Nick Koston 2025-04-17 22:22:59 -10:00 committed by GitHub
parent 8f130abde0
commit ac04afa6c3
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -149,3 +149,9 @@ The entity will be named `Temperature` and will default to having an entity_id o
data: data:
homeassistant.components.esphome: debug homeassistant.components.esphome: debug
``` ```
## Known Limitations
Each ESPHome device must have a **unique name**. This name is important for mDNS announcements, ensuring that the device can be properly discovered, quickly reconnected when it comes online or wakes from deep sleep (for devices that support deep sleep), and correctly linked to the [**ESPHome Device Builder Add-on**](https://my.home-assistant.io/redirect/supervisor_addon/?addon=5c53de3b_esphome&repository_url=https%3A%2F%2Fgithub.com%2Fesphome%2Fhome-assistant-addon). It's also crucial for **DHCP discovery** if mDNS is not available.
Using duplicate names can lead to connection issues, failed discovery, and unexpected behavior with both the integration and the add-on.