{"id":12958,"date":"2026-09-10T12:45:00","date_gmt":"2026-09-10T10:45:00","guid":{"rendered":"https:\/\/www.lukaswojcik.com\/blog\/?p=12958"},"modified":"2026-10-24T06:15:04","modified_gmt":"2026-10-24T04:15:04","slug":"tutorial-eine-mqtt-discovery-nachricht-veroffentlichen-die-im-energie-dashboard-ankommt","status":"publish","type":"post","link":"https:\/\/www.lukaswojcik.com\/blog\/de\/smart-home-de\/tutorials-de-smart-home-de\/tutorial-eine-mqtt-discovery-nachricht-veroffentlichen-die-im-energie-dashboard-ankommt\/","title":{"rendered":"Tutorial: Eine MQTT-Discovery-Nachricht ver\u00f6ffentlichen, die im Energie-Dashboard ankommt"},"content":{"rendered":"

MQTT Discovery beschreibt einen Sensor f\u00fcr Home Assistant. Ein separates Topic transportiert die Messwerte. Das Energie-Dashboard nutzt anschlie\u00dfend geeignete Sensordaten und Statistiken. Diese Schritte sind getrennt zu pr\u00fcfen: G\u00fcltiges JSON allein garantiert weder eine funktionierende Entit\u00e4t noch eine Energiegrafik.<\/p>\n

1. Zuerst die Messgr\u00f6\u00dfe festlegen<\/h2>\n

Das Beispiel erfasst aufgelaufenen Strombezug in kWh. Der Z\u00e4hler steigt normalerweise und kann wieder bei null beginnen. Daf\u00fcr passt total_increasing<\/code>. Ein Lebenszeitz\u00e4hler ohne R\u00fccksetzung kann total<\/code> ohne last_reset<\/code> verwenden. Ein saldierender Z\u00e4hler mit steigenden und fallenden Werten ben\u00f6tigt eine andere Behandlung; total_increasing<\/code> w\u00fcrde echte R\u00fcckg\u00e4nge falsch einordnen.<\/p>\n

Leistung in W beschreibt den momentanen Energieumsatz, Energie in kWh eine aufsummierte Menge. Aktuelle Home-Assistant-Versionen unterst\u00fctzen geeignete Leistungssensoren in den Leistungsfeldern des Dashboards: device_class: power<\/code> mit state_class: measurement<\/code>. Ein W-Messwert darf nicht einfach die Beschriftung kWh erhalten.<\/p>\n

\"Vier
Vier Pr\u00fcfungen von Discovery bis zum Energie-Dashboard<\/figcaption><\/figure>\n

2. Eine g\u00fcltige Sensorkonfiguration ver\u00f6ffentlichen<\/h2>\n

Voraussetzungen sind ein erreichbarer Broker, eine eingerichtete MQTT-Integration und aktivierte Discovery mit dem erwarteten Pr\u00e4fix. Das Beispiel f\u00fcr eine einzelne Komponente verwendet homeassistant\/sensor\/example_meter_import\/config<\/code>. Die Kennungen im Discovery-Topic erlauben Buchstaben, Ziffern, Unterstriche und Bindestriche, keinen beliebigen Freitext.<\/p>\n

Die Datei energy-discovery.json<\/code> beschreibt einen erfundenen Z\u00e4hler. Die stabile eindeutige Kennung muss innerhalb der Installation eindeutig bleiben. Der Anzeigename l\u00e4sst sich unabh\u00e4ngig davon \u00e4ndern.<\/p>\n

{\n  "name": "Imported energy",\n  "state_topic": "example\/meter\/import_kwh",\n  "unique_id": "example_meter_import",\n  "device_class": "energy",\n  "unit_of_measurement": "kWh",\n  "state_class": "total_increasing",\n  "expire_after": 900,\n  "device": {\n    "identifiers": [\n      "example_meter"\n    ],\n    "name": "Example meter"\n  }\n}<\/code><\/pre>\n
state_topic<\/code> ist f\u00fcr einen MQTT-Sensor erforderlich. Weitere Felder richten sich nach der gew\u00fcnschten Funktion. Eine eindeutige Kennung erm\u00f6glicht die Verwaltung \u00fcber das Entit\u00e4tsregister und die hier gezeigte Ger\u00e4tezuordnung; eine allgemeine Pflicht des Energie-Dashboards ist das Feld nicht. Ger\u00e4te-Discovery mit einer gemeinsamen device<\/code>-Nachricht verwendet ein anderes Format mit zus\u00e4tzlichen Pflichtfeldern.<\/p>\n
3. Konfiguration verf\u00fcgbar und Messwerte aktuell halten<\/h2>\n
Das Beispiel speichert die Konfiguration mit Retain beim Broker. Alternativ kann der Sender Discovery nach der Startmeldung von Home Assistant erneut ver\u00f6ffentlichen, normalerweise online<\/code> auf homeassistant\/status<\/code>. Nach Discovery werden au\u00dferdem aktuelle Zust\u00e4nde ben\u00f6tigt. Retain ist damit eine \u00dcbertragungsm\u00f6glichkeit, weder Pflichtfeld noch Garantie f\u00fcr eine Sicherung auf Festplatte bei Brokerausf\u00e4llen.<\/p>\n
Die folgenden Befehle ben\u00f6tigen Mosquitto-Clients ab Version 2.1, da -o<\/code> erst dort verf\u00fcgbar ist. mqtt-client.conf<\/code> enth\u00e4lt Brokeradresse, TLS-Einstellungen und Zugangsdaten als Optionen, jeweils eine pro Zeile. Restriktive Dateirechte sch\u00fctzen die Zugangsdaten; das Passwort steht nicht in der Befehlszeile. Bei \u00e4lteren Versionen ist die Standard-Konfigurationsdatei eine Alternative. F\u00fcr Zustandsnachrichten darf die Datei keine Retain-Option enthalten.<\/p>\n
mosquitto_pub -o .\/mqtt-client.conf -q 1 -r \\\n  -t homeassistant\/sensor\/example_meter_import\/config \\\n  -f energy-discovery.json\nmosquitto_pub -o .\/mqtt-client.conf -q 1 \\\n  -t example\/meter\/import_kwh -m '1234.500'\nmosquitto_pub -o .\/mqtt-client.conf -q 1 \\\n  -t example\/meter\/import_kwh -m '1234.625'<\/code><\/pre>\n
Zuerst l\u00e4uft nur der Konfigurationsbefehl. Vor den beiden Messwertbefehlen m\u00fcssen Entit\u00e4t und Zustandsabonnement bereitstehen; eine erfolgreiche Ver\u00f6ffentlichung beweist noch keine verarbeitete Discovery. Bei einer Umstellung muss au\u00dferdem ein vorhandener Retain-Wert auf dem Zustandstopic entfernt werden. Sp\u00e4tere Nachrichten ohne Retain l\u00f6schen diesen alten gespeicherten Wert nicht.<\/p>\n
Die beiden Beispielwerte unterscheiden sich um 0,125 kWh. Daf\u00fcr ist ein isolierter Testsensor vorgesehen; erfundene Werte geh\u00f6ren nicht in die Historie eines echten Z\u00e4hlers. Der Sender sollte regelm\u00e4\u00dfig und mit ausreichendem Abstand zur eingestellten Ablaufzeit von 900 Sekunden melden.<\/p>\n
Die Zustandsnachrichten verwenden bewusst kein -r<\/code>. Bei expire_after<\/code> k\u00f6nnte ein gespeicherter alter Wert nach erneutem Laden wieder zugestellt werden und frisch erscheinen. Verf\u00fcgbarkeitsmeldungen mit Birth und Will k\u00f6nnen zus\u00e4tzlich einen Verbindungsabbruch anzeigen. Ein Nachweis aktueller physischer Messungen entsteht dadurch nicht.<\/p>\n
4. Jede Stufe getrennt pr\u00fcfen<\/h2>\n