Kapitel 13

Fehlersuche

Die Fälle, über die in der Praxis am häufigsten gestolpert wird — sortiert nach dem, was du siehst. Zu jedem steht, woran es liegt und was hilft.

6 Minuten Zuletzt geprüft: 22.09.2026 DE EN

Es entsteht keine Entität

Alle Werte kommen an, trotzdem kein Gerät in Home Assistant
Das ist mit Abstand der häufigste Fall. Es fehlt die Zeile für die Anmeldungen in der Bridge-Datei, oder die Geräte-ID darin ist falsch geschrieben:

topic homeassistant/+/<NODE>/# in 0

Prüfe die Schreibweise gegen die Geräte-ID in der CampMatic-App und starte das Mosquitto-Add-on danach neu. Speichern allein reicht nicht — die Datei wird nur beim Start gelesen.
Zeile stimmt, trotzdem nichts
Dein CampMatic meldet seine Entitäten beim Verbinden an. Nimm die Box einmal kurz vom Strom; beim nächsten Start meldet sie alles neu an.

Sensoren bleiben leer

Mehrere Sensoren stehen dauerhaft auf „nicht verfügbar"
Prüfe zuerst, ob in deiner campmatic.yaml das Wort mqtt: mehr als einmal vorkommt. YAML erlaubt jeden Eintrag nur einmal — steht er mehrfach da, gilt nur der letzte Block und alle vorher aufgeführten Sensoren verschwinden.

Das Tückische: Die Konfigurationsprüfung meldet keinen Fehler, die Entitäten bleiben sichtbar, und beim Mithören sieht man die Werte ankommen. Man sucht dann lange an der falschen Stelle.

Richtig ist: ein mqtt:, ein template:, alles andere als Liste darunter.
Kurz nach einem Neustart
Direkt nach einem Neustart des Add-ons oder von Home Assistant sind die Bluetooth-Werte für einige Minuten nicht da. Sie werden nicht zwischengespeichert und kommen erst, wenn der jeweilige Sensor das nächste Mal sendet. Das gibt sich von allein — im Unterschied zum Fall darüber.
Nach dem Anlegen neuer Sensoren
Neue MQTT-Sensoren erscheinen erst nach einem echten Neustart von Home Assistant. Wer nur die Konfiguration neu lädt, sieht sie in der Liste, aber dauerhaft ohne Wert.
Einzelner Sensor ohne Wert
Dann stimmt meist die Platznummer nicht. Lies sie noch einmal mit campmatic/<GERAETE_ID>/+/config nach — sie kann sich ändern, wenn ein Sensor neu gekoppelt wurde.

Heizungskarten sind leer

Truma Heizung und Truma Wasser zeigen „nicht verfügbar"
Das ist bekannt und liegt nicht an dir. Bei ausgeschalteter Heizung sendet die Box nan als Sollwert, womit Home Assistant nicht umgehen kann. Die Lösung sind die Ersatzsensoren aus Kapitel 6. Danach benutzt du die Auswahl Warmwasser statt der automatisch angelegten Karte.
Warmwasser lässt sich nicht auf 80 Grad stellen
Richtig so — die Truma kennt für das Warmwasser nur Aus, 40 und 60 Grad. Dass die automatisch angelegte Karte 80 Grad anbietet, ist ein Anzeigefehler. Die Auswahl aus Kapitel 6 bietet nur die drei echten Möglichkeiten.
Vario Heat: die Heizstufe wird falsch angezeigt
Hast du eine Vario Heat, zeigt die automatisch angelegte Karte Truma Heizung den Lüftermodus dauerhaft als „aus", auch während geheizt wird. Das Schalten funktioniert trotzdem. Verlass dich auf die Auswahl Heizstufe, die den richtigen Wert zeigt.

Ebenfalls bei Vario Heat: Die Stufen heißen in Home Assistant Eco und High, an der Heizung selbst aber Nacht und Automatik. Die Beschriftung stimmt nicht, die Wirkung schon.

Kleinigkeiten

Im Protokoll steht dauernd „Protocol error from ::1"
Harmlos. Das ist die Überwachung, die prüft, ob der Broker erreichbar ist. Sie taucht im Protokoll auf, solange das Add-on läuft.
Soll-Temperaturen zeigen „unbekannt"
Normal, solange Heizung und Boiler aus sind. Es gibt dann schlicht keinen Sollwert.
Das Add-on startet nicht mehr
Wenn du gerade customize eingeschaltet hast: Der Ordner /share/mosquitto muss vorher existieren. Fehlt er, bricht das Add-on sofort ab und zeigt nur gestoppt. Im Protokoll steht dann Unable to open include_dir.
Eine Entität heißt anders als erwartet
Home Assistant ersetzt Umlaute: aus ü wird u, aus ä wird a. Aus „Gasflasche Füllhöhe" wird sensor.gasflasche_fullhohe. Kopiere Entitätsnamen aus Entwicklerwerkzeuge → Zustände, statt sie zu tippen.
Werte kommen nur sporadisch
Die Bluetooth-Sensoren senden in Abständen von Sekunden bis Minuten, je nach Typ. Zusätzlich hängt es von der Funkstrecke ab — steht das Fahrzeug weit weg oder liegt Metall dazwischen, kommen Werte seltener. Die Signalstärke jedes Sensors kannst du als Diagnosewert anzeigen lassen.
Immer noch ein Problem?
  • Schreib uns über das Kontaktformular auf der Hilfeseite — am besten mit der Angabe, an welchem Kapitel du hängst und was im Protokoll des Mosquitto-Add-ons steht.