From 28f3589bd5f51293b1a3d8d93127006691e03ff9 Mon Sep 17 00:00:00 2001 From: "J. Nick Koston" Date: Wed, 25 Jun 2025 13:38:53 +0200 Subject: [PATCH] Update ESPHome entity_id docs for unicode chars (#39704) --- source/_integrations/esphome.markdown | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/source/_integrations/esphome.markdown b/source/_integrations/esphome.markdown index c0228670388..a586145fd21 100644 --- a/source/_integrations/esphome.markdown +++ b/source/_integrations/esphome.markdown @@ -152,6 +152,7 @@ The [Native API Component](https://esphome.io/components/api.html) also supports - Entity name is a combination of the friendly name (or name if unset) and component name - Entity ID is derived from the entity name with the device name prepended +- Unicode characters in names are transliterated to their closest ASCII equivalents for compatibility Example with `friendly_name` set: @@ -178,6 +179,19 @@ sensor: The entity will be named `livingroomdesk Temperature` and will default to having an entity ID of `sensor.livingroomdesk_temperature`. +Example with Unicode characters: + +```yaml +esphome: + name: "haloszoba-klima" + friendly_name: "Hálószoba klíma" + +sensor: + name: "Árvíztűrő tükörfúrógép" +``` + +The entity will be named `Hálószoba klíma Árvíztűrő tükörfúrógép` and will default to having an entity ID of `sensor.haloszoba_klima_arvizturo_tukorfurogep`. Note how the Unicode characters are transliterated rather than replaced with underscores. + ## Troubleshooting ### Viewing live logs