Zigbee-apparaten logisch benoemen in Zigbee2MQTT

Elk nieuw Zigbee-apparaat heet eerst iets als 0x001788010645b9c8. Hernoem het direct, en volgens een vast patroon.

Het patroon: ruimte/apparaat

Gebruik in Zigbee2MQTT een friendly name met een schuine streep:

woonkamer/plafondlamp
keuken/knop
slaapkamer/nachtkastje_links
tuin/schuur_bewegingssensor

Home Assistant maakt daar automatisch nette entiteiten van, zoals light.woonkamer_plafondlamp. De schuine streep geeft in MQTT ook een mooie boomstructuur.

Waarom eerst in Zigbee2MQTT

De friendly name in Zigbee2MQTT bepaalt het MQTT-topic. Hernoem je alleen in Home Assistant, dan blijft het topic een hexadres en lopen de namen uit elkaar. Hernoem dus in Zigbee2MQTT en vink Update Home Assistant entity ID aan.

Regels die het overzichtelijk houden

• Ruimte eerst, dan het apparaat. Lijsten sorteren dan vanzelf per kamer.
• Vaste woorden voor apparaattypes: knop, afstandsbediening, bewegingssensor, aanwezigheidssensor, stekker, deursensor.
• Nummer bij meerdere gelijke apparaten: woonkamer/spot_1, _2.
• Geen merknamen in de naam als het apparaat er niet toe doet. Vervang je een Hue-lamp door een IKEA-lamp, dan blijft de naam kloppen.

Spraak: aliassen in twee talen

Voor Assist voeg je per entiteit aliassen toe, ook hier met de ruimte eerst: "Woonkamer plafondlamp" en "Living room ceiling light". Voeg synoniemen toe die mensen echt gebruiken, zoals "kachel", "verwarming" en "radiator".

Let op bij hernoemen

Een nieuwe entity_id breekt automatiseringen, scripts en dashboards die de oude naam gebruiken. Doe het hernoemen vroeg, of zoek daarna in je configuratie naar de oude ID's. Groepen die één lamp omwikkelen ("aliassen") kun je na het hernoemen vaak weggooien. Lees ook wanneer je lampen groepeert.

Veelgestelde vragen

Kan ik namen met spaties gebruiken? Liever niet. Spaties worden in entiteit-ID's underscores, en in MQTT-topics zijn ze lastig. Houd het bij kleine letters, schuine strepen en underscores.

Wat gebeurt er met de geschiedenis als ik hernoem? Hernoem je de entiteit-ID via Zigbee2MQTT met de optie aangevinkt, dan neemt Home Assistant de geschiedenis mee.

Moet ik ook ruimtes instellen in Home Assistant? Ja. Een naam is voor jou, een ruimte voor dashboards en spraakopdrachten. Doe allebei.