Homematic-Anbindung im Labor

Verbinde Homematic-Sensoren mit AirPilot Home. Voraussetzung sind eine Homematic IP Home Control Unit (HCU) und das AirPilot-HCU-Plugin. Ein Homematic IP Access Point oder eine CCU allein genügt für dieses Plugin nicht.

AirPilot Home – HCU-Plugin herunterladen

Version 0.3.5 · ARM64 · Zielsystem HCU-Firmware 1.7.9 · Mindestversion laut Plugin-Metadaten 1.4.7.

HCU-Plugin 0.3.5 herunterladen

Prüfsumme (SHA-256)

Einrichten

1. HCU sichern und bei Bedarf den Entwicklermodus aktivieren. Die Herstellerhinweise dazu gelten weiterhin.
2. In HCUweb unter Plugins das unveränderte .tar.gz-Archiv hochladen. Ist AirPilot bereits installiert, dessen Versionsmenü öffnen und „Aktualisieren“ verwenden.
3. Das Plugin starten und in HCUweb „Konfigurieren“ öffnen. Auf „Mit AirPilot verbinden“ klicken oder den QR-Code mit dem Telefon scannen.
4. Die aktuelle AirPilot-App öffnet sich (iOS ab 1.5 Build 65, Android ab 1.0.5). Falls eine Webseite erscheint, auf „AirPilot öffnen“ tippen. Bei Bedarf anmelden, dann ausdrücklich das Zuhause dieser HCU wählen und die Zuordnung bestätigen. Bei mehreren eigenen Häusern wird keines vorausgewählt. Der Link gilt zehn Minuten. Bei Ablauf die Plugin-Konfiguration erneut öffnen. Beim Überschreiben kann die bisherige Kopplung verloren gehen; dieselbe HCU behält bei Wiederkopplung mit demselben Konto und Haus ihre Sensor-IDs.
5. In AirPilot im Schritt „Verbindung prüfen“ auf die ersten Daten warten. Die App bestätigt die Verbindung automatisch. Nach dem ersten erfolgreichen Sensorupload erscheinen die Homematic-Sensoroptionen. Temperatur und Feuchte ausdrücklich einer Zone zuordnen; ohne Zuordnung bleibt deren bisherige Quelle bestehen.

Welche Daten werden übertragen?

Auch Heizkörperthermostate sind als Temperaturquelle auswählbar. Ihr Messpunkt liegt direkt am Heizkörper; ein Wandthermostat eignet sich meist besser für die Raumtemperatur und kann je nach Modell zusätzlich die Luftfeuchtigkeit liefern. Das Plugin liest den HCU-Zustand regelmäßig neu ein, auch wenn sich Messwerte nicht ändern.

Das Plugin sendet verfügbare Temperatur, Luftfeuchtigkeit und Thermostat-Solltemperatur samt Sensorname, Modell, Raum, Erreichbarkeit und Beobachtungszeit ausgehend per HTTPS an den AirPilot-Server. Erst die ausdrückliche Bestätigung in der App ordnet die HCU deinem ausgewählten AirPilot-Haus zu. Homematic-Zugangstoken bleiben auf der HCU. Es ist keine Router-Portfreigabe erforderlich.

Solltemperaturen werden getrennt von gemessenen Raumtemperaturen angezeigt. Die Übernahme einer Thermostat-Solltemperatur lässt sich pro Zone einschalten und ist standardmäßig aus. Dazu wird ein Thermostat ausgewählt. Fehlen aktuelle Daten, nutzt AirPilot den gespeicherten manuellen Sollwert. Die separate Zuordnung zu einzelnen Lüftern folgt später.

Die Lüfter bleiben mit der Ambientika-Cloud verbunden. Das Plugin verändert weder Thermostateinstellungen noch die Serveradresse deiner Lüfter.

CO₂ und Fensterkontakte vorbereiten

Ab Plugin 0.3.4 werden zusätzlich verfügbare CO₂-Werte und Zustände echter Fensterkontakte übertragen und in der Sensorhistorie gespeichert. In aktuellen Apps lassen sich ein CO₂-Sensor und mehrere Fensterkontakte pro Zone zuordnen. In iOS ab 1.5 (68) und Android ab 1.0.9 können die zugeordneten Sensoren als Szenenbedingungen verwendet werden: Temperatur und CO₂ über/unter einem Grenzwert sowie Fenster offen, gekippt oder geschlossen. Temperatur und Feuchte verwenden die eingestellten Zonenquellen. Fehlende oder veraltete Messwerte erfüllen keine Bedingung. „Fenster geschlossen“ setzt aktuelle geschlossene Zustände aller zugeordneten Kontakte voraus. Szenen laufen auf dem AirPilot-Server; es wird keine Szene automatisch eingeschaltet. CO₂- und Kontaktmodelle müssen noch mit echten Geräten erprobt werden.

Trennen und Rückbau

In AirPilot die HCU-Verbindung trennen, um deren Upload-Zugang zu widerrufen. Anschließend im HCU-Plugin die lokale Verbindung entfernen oder das Plugin deinstallieren. Bereits ausgewählte Sensorquellen anschließend kontrollieren. Ein Rückbau des HCU-Entwicklermodus richtet sich nach den Herstellerangaben und kann die Wiederherstellung eines Backups erfordern.

Haftungs- und Laborhinweis

Das Laborangebot dient der Erprobung. Wir geben für diesen experimentellen Stand keine Zusage zu unterbrechungsfreiem Betrieb, vollständiger Geräteunterstützung oder Eignung für sicherheitsrelevante Aufgaben. Bitte ausschließlich in einer gesicherten, kontrollierten Installation testen. Dieser Hinweis ist kein pauschaler Haftungsausschluss; zwingende gesetzliche Rechte und Haftungsansprüche bleiben unberührt.

Stand: 17. Oktober 2026