Als ich den ersten Leitfaden zur Verbindung der Ajax-Alarmanlage mit Home Assistant verfasst hatte, musste man zwischen SIA, Jeedom, MQTT, den Themen jonglieren… Das Ergebnis funktionierte perfekt, aber man musste die komplexen Systeme lieben. Heute, ein völliger Szenenwechsel: Entwickler haben eine native Ajax Home Assistant-Integration entwickelt, die über HACS installiert werden kann und direkt mit der offiziellen Ajax Cloud-API kommuniziert. Armierung, Deaktivierung, Benachrichtigungen, Sensoren, Relais… alles wird in Home Assistant in (fast) Echtzeit übertragen!
Seit einige Tagen bei mir installiert, lade ich Sie ein, dieses lang erwartete Plugin etwas genauer zu entdecken…
Kurze Erinnerung an die alten Methoden
Bisher gab es zwei Ansätze, um über Ajax Home Assistant zu sprechen.
Der erste erfolgte über die SIA-Alarmanlagenintegration von Home Assistant. Die Ajax-Alarmanlage wurde so konfiguriert, als ob Home Assistant ein Überwachungszentrum wäre. Man erhielt den Status des Systems, einige Informationen zu Feuer-/Überschwemmungswarnungen, und das war’s. Es war unmöglich, die Alarmanlage zu steuern, keine Details zu jedem Sensor. Es war vor allem nützlich, um einige Szenarien basierend auf dem Gesamtstatus der Alarmanlage auszulösen, wie zum Beispiel die Heizung in den Eco-Modus zu versetzen, wenn man die Alarmanlage beim Verlassen des Hauses aktiviert hat.
Die zweite Methode, die in meinem vorherigen Leitfaden detailliert beschrieben wurde, bestand darin, das Ajax-Plugin auf Jeedom zu verwenden und dann alle Informationen über MQTT in Home Assistant zu republizieren. Viel umfassender, mit der Übertragung von nahezu allen Ajax-Sensoren, aber auf Kosten eines zweiten Smart-Home-Servers, eines MQTT-Brokers, einer Zuordnung von Dutzenden von Themen… Kurz gesagt, sehr leistungsstark, aber eindeutig nicht für jedermann geeignet.
Das neue Plugin ändert das Spiel komplett: Ajax Home Assistant wird ein viel einfacher zu implementierendes Paar.
Was das neue Ajax Home Assistant-Plugin ermöglicht
Die Integration ajax-hass ist eine benutzerdefinierte Komponente für Home Assistant, die direkt mit der Ajax Cloud über die offizielle API und einen gRPC-Stream verbunden wird, genau wie die Ajax-Mobile-App. Konkret wird Ihr Ajax-Hub zu einem „First-Class Citizen“ in Home Assistant, mit einem echten Alarmfeld und Entitäten für Sensoren, Sirenen, Relais, Steckdosen usw.
Sie erhalten insbesondere eine vollständige Kontrolle über die Sicherheit. Das Home Assistant-Alarmfeld ermöglicht die vollständige Armierung, Deaktivierung, den Nachtmodus, die partielle Armierung nach Gruppen und sogar die forcierte Armierung, wenn einige Sensoren offen bleiben. Ein spezieller Dienst verwaltet den Panikknopf, den man auf einem Dashboard oder auf einer virtuellen Fernbedienung platzieren kann.
Was die Informationsübertragung betrifft, so stellt das Plugin die Ereignisse der Armierung/Deaktivierung mit dem Namen des Ajax-Benutzers, Alarmbenachrichtigungen, Bewegungserfassungen, Öffnungen von Türen und Fenstern, Brand- oder Überschwemmungsalarme sowie „technische“ Sensoren wie Batteriestand, Signalqualität, Temperatur oder Verbindungsstatus zur Verfügung. Es ist sehr umfassend.
Die Integration verwaltet mehrere Ajax-Hubs im selben Home Assistant, falls erforderlich, und die Benutzeroberfläche ist bereits ins Deutsche übersetzt. In Bezug auf die Ausrüstungsreichweite testet der Entwickler in erster Linie den Hub 2 Plus und die MotionCam, aber das Design basiert auf der offiziellen Ajax-API und die Community hat bereits eine gute Anzahl von Tastaturen, Sirenen, Öffnungskontakten, Brandmeldern usw. validiert.
So haben wir ein echtes Tandem Ajax Home Assistant, das in der Lage ist, das Alarmsystem präzise zu steuern und zu überwachen, ohne Umwege.
Die Vorbereitung Ihrer Ajax- und Home Assistant-Installation
Bevor Sie starten, ist es besser, einige Voraussetzungen zu überprüfen.
Ihr Ajax-System muss betriebsbereit sein, mit einem Hub, der in der offiziellen Anwendung konfiguriert ist, alle Sensoren richtig hinzugefügt und benannt sind, und wenn möglich, die Gruppen bereits definiert sind (Erdgeschoss, Etage, Garage usw.). Je sauberer die Ajax-Konfiguration ist, desto angenehmer wird der Home Assistant-Bereich sein.
In Bezug auf die Hausautomation benötigt man ein aktuelles Home Assistant mit HACS, das bereits installiert und funktionsfähig ist, da das Ajax Home Assistant-Plugin als benutzerdefinierte Integration verteilt wird. Überprüfen Sie auch, dass Ihre Home Assistant-Instanz über einen ausgehenden Internetzugang zu den Ajax-Servern verfügt, da die Kommunikation über die Cloud via HTTPS und gRPC erfolgt.
Stellen Sie schließlich sicher, dass Ihre Home Assistant-Installation ordnungsgemäß gesichert ist: starkes Passwort, geschützter Fernzugriff (Reverse Proxy, Authentifizierung, TLS-Zertifikat) und regelmäßige Backups. Die Integration Ihres Alarmsystems in Ihre Hausautomation ist sehr praktisch, erfordert jedoch mehr Sorgfalt bei der allgemeinen Sicherheit der Infrastruktur.
Installation der Ajax-Integration über HACS
Kommen wir zum Praktischen. Ist HACS bereits auf Ihrem Home Assistant eingerichtet? Perfekt, dann können wir mit der Installation des Ajax Home Assistant-Plugins beginnen.
Der erste Schritt besteht darin, das GitHub-Repository des Plugins in HACS zu deklarieren. Öffnen Sie in der Benutzeroberfläche von Home Assistant HACS und dann den Abschnitt für Integrationen. Oben rechts gibt es einen Button mit drei kleinen Punkten, der den erweiterten Menüzugang bietet. Wenn Sie den Eintrag „Benutzerdefinierte Repositories“ auswählen, können Sie ein neues Repository hinzufügen.
Geben Sie im URL-Feld die Adresse des Repositories https://github.com/foXaCe/ajax-hass ein und wählen Sie „Integration“ als Kategorie. Bestätigen Sie, und schließen Sie das Fenster. Das nächste Mal, wenn Sie in HACS nach einer Integration suchen, wird „Ajax Security System“ in der Liste erscheinen.
Suchen Sie weiterhin in HACS nach „Ajax Security System“, öffnen Sie das entsprechende Blatt und installieren Sie es.
HACS wird die Komponente ajax-hass herunterladen und sie im custom_components/ajax-Verzeichnis Ihrer Home Assistant-Installation ablegen.
Nach Abschluss der Installation ist ein Neustart von Home Assistant erforderlich, um die neue Integration zu laden.
Hinzufügen der Ajax Home Assistant-Integration in Home Assistant
Nachdem Home Assistant neu gestartet wurde, können wir zur Konfiguration übergehen. Alles erfolgt über die Benutzeroberfläche, ganz ohne YAML, was sehr erfreulich ist!
Öffnen Sie das Menü „Einstellungen“ und dann „Geräte und Dienste“. Unten auf der Seite verwenden Sie die Schaltfläche „Integration hinzufügen“. Geben Sie im Suchfeld „Ajax“ ein. Sie sollten „Ajax Security System“ mit dem entsprechenden Icon sehen. Wählen Sie es aus, um den Konfigurationsassistenten zu starten.
Die Integration fragt dann nach den Anmeldedaten Ihres Ajax-Kontos, also der E-Mail-Adresse und dem Passwort, die in der offiziellen Anwendung verwendet werden. Das Plugin benötigt keine lokale IP-Adresse des Hubs oder exotische Ports, alles läuft über die Ajax Cloud.
Als nächstes kommt eine sehr praktische Einstellung: der Benachrichtigungsfilter. Sie können wählen, ob Sie keine Benachrichtigungen in Home Assistant, nur Einbruchalarme, Sicherheitsereignisse (Armierung/Deaktivierung, technische Warnungen) oder alles, einschließlich Sensorereignisse in Echtzeit, verfolgen möchten. Wenn man plant, viele Automatisierungen mit Ajax Home Assistant zu erstellen, ist es oft sinnvoll, mindestens mit den Sicherheitsereignissen zu beginnen und dann anzupassen.
Bestätigen Sie, warten Sie einige Sekunden: Die Integration kontaktiert die Ajax Cloud und ruft die Liste Ihrer Hubs ab. Hier habe ich zum Beispiel 3 verschiedene Ajax-Systeme: ich kann alle hinzufügen oder nur das auswählen, das mich interessiert, wie hier „Maison“.
Wir bestätigen. Das System ruft dann die Gruppen und alle Geräte des oder der ausgewählten Hubs ab und erstellt die entsprechenden Entitäten in Home Assistant. Danach können wir ihnen, wenn gewünscht, einen Raum zuweisen:
Was wir in Home Assistant nach der Integration finden
Sobald die Ajax Home Assistant-Integration eingerichtet ist, ermöglicht ein kurzer Besuch in „Geräte und Dienste“ einen Überblick über das Ergebnis. Jeder Ajax-Hub erscheint als Gerät, mit einem Haupt-Alarmfeld und einem Satz von Sensoren und Aktoren.
Das Alarmfeld, das als alarm_control_panel-Entität angezeigt wird, ermöglicht es, das gesamte Haus zu armierten, in den Nachtmodus zu wechseln, zu deaktivieren und die partielle Armierung nach Gruppen zu verwenden, falls Sie dies in der Ajax-Anwendung konfiguriert haben. Diese Entität wird zum zentralen Punkt Ihrer Sicherheitszenarien.
Die Bewegungsmelder werden als klassische binary_sensor-Entitäten angezeigt, die den Status „on“ im Falle einer Erkennung annehmen und nach der Sperrzeit wieder auf „off“ zurückkehrt. Die Kontakte von Türen und Fenstern erscheinen ebenfalls als binäre Sensoren, perfekt zum Auslösen von Szenarien wie das Ausschalten der Heizung, wenn ein Fenster zu lange offen bleibt.
Die Rauch-, Kohlenmonoxid- oder Überschwemmungsmelder werden ebenfalls als direkt nutzbare Entitäten bereitgestellt.
Die Ajax-Steckdosen und Relais werden als Schalter oder Aktoren angezeigt, die von Home Assistant gesteuert werden können. Man kann zum Beispiel Ajax-Relais ansteuern, um die Stromversorgung eines Geräts im Falle eines Vorfalls zu unterbrechen.
Für die Peniblen erscheint auch eine ganze Reihe von „technischen“ Sensoren: Batteriestand, Signalstärke, Temperatur, Verbindungsstatus usw. Dies sind gute Grundlagen, um ein Dashboard „Systemgesundheit von Ajax“ in Home Assistant zu erstellen.
Beispiele für Szenarien von Ajax Home Assistant in Aktion
Sobald alles in Home Assistant angezeigt wird, beginnt der spannendste Teil: die Automatisierungen. Die Stärke dieser Ajax Home Assistant-Integration besteht genau in der Reaktivität der Ereignisübertragungen und in der Möglichkeit, die Alarmanlage zu steuern.
Ein erstes sehr nützliches Szenario besteht darin, die Alarmanlage automatisch zu aktivieren, wenn alle das Haus verlassen. Man nutzt die Anwesenheit von Personen über die Home Assistant-Mobile-App oder ein anderes Präsenzsystem und löst eine vollständige Armierung aus, sobald die letzte Person auf „not_home“ wechselt.
Ein minimalistisches Beispiel in YAML könnte so aussehen:
automation:
- alias: "Ajax armieren, wenn alle weg sind"
trigger:
- platform: state
entity_id: group.famille
to: "not_home"
action:
- service: alarm_control_panel.alarm_arm_away
target:
entity_id: alarm_control_panel.ajax_alarm_home
Man kann sich das Gegenteil bei der Rückkehr vorstellen: automatische Deaktivierung, wenn die erste Person ankommt, begleitet von einem sanften Einschalten einiger Lichter und der Deaktivierung bestimmter Szenarien zur simulierten Präsenz.
Ein weiterer häufiger Anwendungsfall betrifft die Heizung. Die Ajax-Öffnungssensoren, die in Home Assistant hochgeladen werden, ermöglichen es, eine elektrische Heizung oder Klimaanlage sofort abzuschalten, sobald ein Fenster länger als fünf Minuten offen bleibt, und das System wieder zu aktivieren, wenn das Fenster geschlossen wird. Es ist nicht mehr nötig, Zigbee- oder Z-Wave-Sensoren zu vervielfachen, um sauber mit den Öffnungen zu arbeiten.
Die Bewegungsmelder von Ajax können auch zur Steuerung der Beleuchtung beitragen. Man kann entscheiden, dass nachts nur das Vorbeigehen vor einem Sensor im Flur eine Nachtbeleuchtung oder einen LED-Streifen am Fußende des Bettes bei geringer Intensität für einige Minuten auslöst. Der Alarm wird nicht ausgelöst, aber die Infrastruktur wird für Komfort wiederverwendet. Das gehört zu den kleinen Freuden der gut integrierten Hausautomation.
Schließlich kann der Ajax-Panikknopf, der als „button“-Entität angezeigt wird, auf einem Dashboard für Erwachsene platziert oder sogar hinter einer passwortgeschützten Karte verborgen werden und verwendet werden, um einen allgemeinen Alarm auszulösen: Sirenen, Außenbeleuchtung auf 100 %, Benachrichtigungen auf das Smartphone senden oder sogar einen automatischen Anruf an einen Bekannten über einen Drittanbieter-Service tätigen. In solchen Szenarien ist es natürlich am besten, in realen Bedingungen zu testen, aber vorher alle zu informieren…
Sicherheit und gute Praktiken mit Ajax Home Assistant
Die Integration von Ajax in Home Assistant über dieses Plugin bedeutet, dass Home Assistant ein weiteres Glied in der Sicherheitskette wird. Der Entwickler hat die Datenschutz-Seite sorgfältig gestaltet: Die Anmeldedaten werden im verschlüsselten System von Home Assistant gespeichert, das Passwort wird vor dem Versand an die Ajax-Server gehasht, die Kommunikationen erfolgen über TLS, und es werden keine Daten an Dritte gesendet. Die Integration ist Open Source und überprüfbar, was für ein Sicherheitssystem beruhigend ist.
Man sollte dennoch einige Grundsätze beibehalten. Ein beliebig exponiertes Home Assistant im Internet wird zu einem Eingang zu Ihrem Alarmsystem. Daher ist es entscheidend, den externen Zugang zu sichern, Home Assistant sowie die Ajax-Integration auf dem neuesten Stand zu halten und die Anzahl der Administratorkonten zu minimieren. Die erzwungene Armierung sollte ebenfalls sparsam verwendet werden, da sie es ermöglicht, das System auch bei offenen oder defekten Sensoren zu aktivieren.
Letzter Punkt: Dieses Plugin basiert auf der Ajax Cloud. Wenn Ihre Internetverbindung ausfällt oder die Ajax-Server nicht erreichbar sind, wird der Hub weiterhin das Haus schützen, aber die Echtzeitleitung mit Home Assistant wird unterbrochen.
In der Praxis, warum dieses Ajax Home Assistant-Plugin annehmen
Zusammenfassend lässt sich sagen, dass wir von einer „gepatchten“ Integration, die von einem zweiten Smart-Home-System abhängig ist, zu einem dedizierten, gewarteten Ajax Home Assistant-Plugin übergehen, das eine sehr tiefe Verwaltung der Geräte ermöglicht. Die Installation erfolgt über HACS, die Konfiguration ausschließlich über die Benutzeroberfläche, und man erhält eine vollständige Kontrolle über die Alarmanlage mit nahezu sofortiger Ereignisübertragung.
Im Alltag bedeutet das intelligenteres Szenarien, echte Kohärenz zwischen Sicherheit und Komfort und weniger Duplizierung von Sensoren im ganzen Haus. Für Installateure ist das auch ein starkes Argument, um es den Kunden, die bereits mit Ajax ausgestattet sind, zu präsentieren, die von einer globalen Steuerung ihres Hauses mit Home Assistant träumen.
Und das Angenehmste an der Geschichte ist, dass „vollständiger“ nicht mehr mit „komplizierter“ gleichbedeutend ist.
