From ac04afa6c3dd30756a0f4dc1647f5444813b63ad Mon Sep 17 00:00:00 2001 From: "J. Nick Koston" Date: Thu, 17 Apr 2025 22:22:59 -1000 Subject: [PATCH] Add known limitations section to ESPHome (#38618) --- source/_integrations/esphome.markdown | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/source/_integrations/esphome.markdown b/source/_integrations/esphome.markdown index 22b21a8c2c3..a107a4f5143 100644 --- a/source/_integrations/esphome.markdown +++ b/source/_integrations/esphome.markdown @@ -149,3 +149,9 @@ The entity will be named `Temperature` and will default to having an entity_id o data: 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.