Debugging & Troubleshooting

Mit den folgenden Befehlen können im Fehlerfall die entsprechenden Hintergrunddienste (Services) neu gestartet und deren Konsolenausgaben (Logs) zur Fehlerdiagnose live mitgelesen werden.

1. Raspberry Pi Befehle (Dienste & Logs)

Dienste neu starten:

Bash
sudo systemctl restart smart_facility_management.service
sudo systemctl restart cloud_sync.service

Status abfragen (Läuft der Dienst fehlerfrei?):

Bash
sudo systemctl status smart_facility_management.service
sudo systemctl status cloud_sync.service

Live-Logs ansehen (mit STRG+C beenden): Lädt die letzten 50 Zeilen und zeigt neue Ereignisse in Echtzeit an.

Bash
sudo journalctl -u smart_facility_management.service -n 50 -f
sudo journalctl -u cloud_sync.service -n 50 -f

Docker-Container verwalten:

Bash
docker ps -a                  # Zeigt den Status aller Docker-Container
docker logs homeassistant -f  # Zeigt die Live-Fehlerausgabe des Home Assistant Containers

Wichtiger Hinweis zum Cloud Sync: Vereinzelte, unregelmäßig auftretende „Keine Internetverbindung“-Meldungen im cloud_sync.service sind normal. Sie bedeuten lediglich, dass es zum exakten Meldungszeitpunkt einen kurzen Zugriffsfehler gab. Das System fängt dies automatisch ab und versucht es im nächsten Zyklus erneut.

2. Homematic IP - Bekannte Probleme & Lösungen

Fehler: Ein erreichbarer CO2-Sensor sendet 0 ppm oder "unknown ppm".

  • Lösung: Der Sensor muss neu gestartet/zurückgesetzt werden (die Konfigurationsdaten in der Zentrale bleiben dabei erhalten).
  • 1. Den Sensor aus der Wandhalterung nehmen.
  • 2. Die Systemtaste am Sensor drücken und gedrückt halten, während der Sensor wieder in die Halterung gesetzt wird.
  • 3. Die Taste weiter gedrückt halten, bis die LED schnell blinkt.
  • 4. Die Taste loslassen und noch einmal kurz drücken. Der Sensor startet nun neu.

Fehler: Plötzlich auftretende „Gerätekommunikation gestört“-Servicemeldungen in der CCU3.

  • Lösung 1 (Abwarten): Oftmals lösen sich diese Probleme nach kurzer Zeit von alleine, wenn das Funknetzwerk sich neu ordnet.
  • Lösung 2 (Aufwecken): Das betroffene Thermostat oder den Fensterkontakt einmal physisch bedienen (Taste drücken/Fenster öffnen) oder über die WebUI manuell ansteuern.
  • Lösung 3 (Hard-Reset): Hilft beides nicht, sollten die Batterien des Geräts für einige Sekunden entfernt und wieder eingesetzt – oder bei niedrigem Ladestand komplett ausgetauscht – werden.

Fehler: Ventilstellbereichsfehler (Oft als Fehlercode "F2" im Display).

  • Lösung 1 (Neustart): In seltenen Fällen hat sich das Thermostat nur verschluckt. Die Batterien kurz entfernen, wieder einsetzen und die Adaptierfahrt (Kalibrierung) abwarten.
  • Lösung 2 (Mechanik anpassen): In der Regel ist der Hub-Stift des Heizungsventils zu kurz. Das Thermostat drückt ins Leere. Zur Behebung muss mit geeigneten, stabilen Distanzhaltern (z. B. kleinen Münzen (1- oder 2-Cent-Stücke) oder passenden Unterlegscheiben) der Stellweg künstlich verlängert werden, bevor das Thermostat wieder aufgeschraubt wird.
Last modified: Friday, 5 June 2026, 11:17 AM