Update ESPHome entity_id docs for unicode chars (#39704)

This commit is contained in:
J. Nick Koston 2025-06-25 13:38:53 +02:00 committed by GitHub
parent f11446a887
commit 28f3589bd5
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -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