X-Sense Smart-Home-Integration, kostenlos und Open Source
X-Sense Rauch-, CO-, Hitze- und Wassermelder in Gladys: Alarme, Batterie, Basisstation.
Veröffentlicht von guim31
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.1.0
- ★ 0
Sicherheit zuerst. Gladys ersetzt nicht die Sirenen deiner Melder und ist kein Überwachungsdienst. Die Alarme laufen über die X-Sense-Cloud und kommen nach einigen Sekunden (manchmal später) in Gladys an, und gar nicht, wenn dein Internetzugang, die X-Sense-Cloud oder Gladys ausfällt. Nutze diese Integration für zusätzliche Benachrichtigungen und Automationen (Licht an, Heizung aus, Nachricht an die Nachbarn), nie als einzige Warnung.
Überblick
Diese Integration bringt die X-Sense Rauch-, Kohlenmonoxid- (CO), Hitze- und Wassermelder in Gladys, über die X-Sense-Cloud — die der App X-Sense Home Security:
- ein Gladys-Gerät pro Melder: laufender Alarm, Batterie, Online, Funk- oder WLAN-Signal und letzter Selbsttest;
- ein Gladys-Gerät pro Basisstation (SBS50, SBS10): Online und WLAN-Signal;
- Szenen-Auslöser: Feueralarm, CO-Alarm, Wasserleck und schwache Batterie, mit Name und Raum des Melders;
- ein Dashboard-Widget mit allen Meldern, Alarme zuerst.
Die Alarme kommen live an (derselbe Push-Kanal wie die App), und die Integration liest die Cloud zusätzlich alle paar Minuten als Sicherheitsnetz.
Ohne die Hardware entwickelt: Rückmeldungen willkommen. Diese Integration ist nicht mit X-Sense verbunden; X-Sense ist eine Marke ihres Inhabers.
Voraussetzungen
- X-Sense-Melder, die in der App X-Sense Home Security mit einem X-Sense-Konto verknüpft sind: Funkmelder an einer Basisstation SBS50 (oder SBS10) oder WLAN-Melder (XS01-WX, XC04-WX, SC07-WX…).
- E-Mail-Adresse und Passwort dieses Kontos. Ein mit „Mit Google/Apple anmelden“ angelegtes Konto hat kein Passwort: lege ein normales Konto an.
- Ein zweites X-Sense-Konto für Gladys (dringend empfohlen): Ein Konto kann nicht gleichzeitig in der App und in Gladys angemeldet bleiben, beide würden sich ständig gegenseitig abmelden. Lege in der App ein zweites Konto an und teile deine Melder von deinem Hauptkonto aus damit (derselbe Rat wie bei der Home-Assistant-Integration).
- Gladys 5.1.0 oder neuer, mit Internetzugang.
Konfiguration
In Gladys Integrationen → X-Sense → Konfiguration:
| Feld | Beschreibung |
|---|---|
| E-Mail-Adresse | E-Mail-Adresse des X-Sense-Kontos. |
| Passwort | Sein Passwort. Von Gladys gespeichert; die Integration behält nur die Sitzungstokens in ihrem privaten Volume /data. |
| Sprache der Funktionsnamen | Sprache der Funktionsnamen eines neuen Geräts (Gladys behält den Namen einer Funktion nach dem Anlegen) und der Selbsttest-Ergebnisse. Standard: Französisch. |
| Cloud-Leseintervall (min) | Minuten zwischen zwei vollständigen Lesevorgängen der Cloud (1 bis 60, Standard 5). Die Alarme warten nicht darauf, denn sie kommen live. Dieses Lesen aktualisiert Batterie- und Signalwerte. |
Speichere und drücke dann Verbindung testen: Das Ergebnis listet die gefundenen Melder. Öffne den Reiter Erkennung und füge die gewünschten Geräte hinzu.
Kontingente und Nutzungsbedingungen. X-Sense veröffentlicht keine öffentliche API: Die Integration nutzt die private API der App, wie die Home-Assistant-Integration, nur lesend. Um die X-Sense-Server zu schonen, liest sie die Geräteliste alle 30 Minuten, den Zustand jeder Basisstation im obigen Intervall (Standard 5 Minuten, das Tempo der Home-Assistant-Integration) und hält eine einzige Live-Verbindung pro Konto. Stelle das Intervall nicht kürzer ein als nötig. X-Sense kann diese API jederzeit ändern oder schließen.
Geräte
Melder (einer pro Rauch-, CO-, Kombi-, Hitze- oder Wassermelder):
| Funktion | Werte |
|---|---|
| Rauchalarm | 1, wenn der Melder im Rauchalarm ist (Rauch- und Kombimelder). |
| CO-Alarm | 1, wenn der Melder im Kohlenmonoxid-Alarm ist (CO- und Kombimelder). |
| Hitzealarm | 1, wenn der Hitzemelder im Alarm ist. Als Rauchsensor angezeigt: Gladys hat keine Hitze-Kategorie, und es ist ein Feueralarm. |
| Wasserleck | 1, wenn der Wassermelder Wasser erkennt. |
| Batterie | Batterie in %. X-Sense meldet nur 4 Stufen: 0, 33, 67 oder 100 %. 33 % und weniger gilt als „schwach“. |
| Online | 1, wenn der Melder mit seiner Basisstation spricht (oder mit der Cloud bei einem WLAN-Melder). |
| Funksignal | Funkmelder: 0 bis 3 Balken zur Basisstation. |
| WLAN-Signal | WLAN-Melder: Signal in dBm (-100 bis -40). |
| Letzter Test | Ergebnis und Datum des letzten Selbsttests (Taste am Melder oder Test aus der App), z. B. „Bestanden · 12.10.26, 10:03“. Leer bis zum ersten Test nach der Installation der Integration. |
Basisstation (SBS50, SBS10): Online und WLAN-Signal (dBm).
Alles ist nur lesend. Der CO-Wert in ppm, wenn der Melder ihn meldet, wird im Widget angezeigt und vom Auslöser „CO-Alarm“ mitgeliefert (Gladys hat keine Funktion, um einen CO-Wert anzuzeigen).
Widget
X-Sense-Melder: drei Kacheln (Melder im Alarm, schwache Batterien, Geräte offline) und eine Zeile pro Melder — Name, Raum, Zustand und Batterie — mit den Alarmen zuerst, dann den Meldern offline, dann den schwachen Batterien. Bis zu 10 Melder werden aufgelistet, eine Bildunterschrift zählt die übrigen. Das Widget aktualisiert sich sofort, wenn ein Alarm beginnt oder endet.
Szenen-Auslöser
Alle vier lassen sich auf einen Melder beschränken (Feld leer lassen für alle Melder). Deren Variablen kannst du in
den Aktionen der Szene verwenden, z. B. in einer Nachricht: {{triggerEvent.data.device_name}}.
| Auslöser | Wann | Variablen |
|---|---|---|
| Feueralarm (Rauch oder Hitze) | Ein Melder löst einen Rauch- oder Hitzealarm aus. Filter: Ursache. | device_name, room, cause (smoke oder heat) |
| CO-Alarm | Ein Melder löst einen Kohlenmonoxid-Alarm aus. | device_name, room, co_ppm |
| Wasserleck | Ein Wassermelder erkennt Wasser. | device_name, room |
| Batterie schwach | Die Batterie eines Melders wird schwach (einmal pro Zeitraum, auch nach einem Neustart). | device_name, room, battery |
Ein Alarm, der beim Start der Integration schon läuft, löst einmal aus. Die Funktionen oben lassen sich auch direkt als Auslöser verwenden („der Rauchalarm des Küchenmelders wird 1“).
Aktion
Verbindung testen (Konfiguration): meldet sich an, liest das Konto und listet die gefundenen Melder. Verwende sie nach einer Passwortänderung: Ein abgelehntes Passwort wird nicht automatisch erneut versucht, damit das Konto nicht gesperrt wird.
Es gibt keinen Befehl: Die Integration schaltet nie etwas stumm, testet oder schärft nichts. Einen Alarm aus der Ferne stummschalten geht absichtlich nur in der X-Sense-App.
Szenenbeispiele
- Feuer in der Nacht: Auslöser „Feueralarm“ → alle Lichter an, die Rollläden des Fluchtwegs öffnen, „🔥 Feueralarm: {{triggerEvent.data.device_name}} ({{triggerEvent.data.room}})“ an alle Benutzer senden.
- Kohlenmonoxid: Auslöser „CO-Alarm“ → die smarte Steckdose des Heizkessels ausschalten, die Lüftung einschalten, „CO {{triggerEvent.data.co_ppm}} ppm in {{triggerEvent.data.room}}: raus und lüften“ senden.
- Wasserleck: Auslöser „Wasserleck“ → das Wasserventil schließen, eine Nachricht mit dem Raum senden.
- Wartung: Auslöser „Batterie schwach“ → „Batterie von {{triggerEvent.data.device_name}} wechseln“ senden.
Fehlerbehebung
- „X-Sense lehnt die E-Mail-Adresse oder das Passwort ab“: Prüfe sie in der X-Sense-App (ab- und wieder anmelden). Mit Google/Apple angelegte Konten haben kein Passwort. Speichere danach die Konfiguration erneut oder drücke Verbindung testen.
- „X-Sense-Cloud nicht erreichbar“: Gladys hat keinen Internetzugang, oder die X-Sense-Cloud ist ausgefallen. Die Integration versucht es selbst erneut und meldet, wenn sie wieder da ist.
- Ein Melder fehlt: Nur Rauch-, CO-, Hitze- und Wassermelder werden aufgelistet (keine Kameras, Tastaturen, Bewegungs- oder Türsensoren, Thermo-Hygrometer). Drücke Verbindung testen und öffne dann den Reiter Erkennung.
- „Kein aktueller Wert“ bei einer Batterie: Die Integration veröffentlicht jeden Wert mindestens alle 6 Stunden neu; wenn es bleibt, sieh dir die Logs der Integration an.
- Die Handy-App meldet sich ständig ab, oder Gladys verbindet sich ständig neu: Beide nutzen dasselbe Konto. Verwende ein zweites X-Sense-Konto mit geteilten Meldern (siehe Voraussetzungen).
- Mehr Details in den Logs: Setze
LOG_LEVEL=debugam Container der Integration.
Einschränkungen
- Nur Cloud: kein lokaler Zugriff auf die Basisstation. Ohne Internet bekommt Gladys nichts — die Melder piepen trotzdem.
- Die Alarmverzögerung hängt von der X-Sense-Cloud ab: meist einige Sekunden, manchmal mehr.
- Nur lesend: kein Stummschalten, kein Test, keine Feuerübung, kein Scharfschalten aus Gladys.
- Der CO-Wert in ppm ist keine Gerätefunktion (Gladys hat noch keine); Widget und CO-Auslöser liefern ihn.
- Der Text „Letzter Test“ erscheint erst nach einem Test, während die Integration läuft.
- Inoffizielle API, von der Community untersucht (python-xsense, Home-Assistant-Integration): X-Sense kann sie ändern.
- Ohne die Hardware entwickelt: Rückmeldungen willkommen im GitHub-Repository.
Konfigurationseinstellungen
Diese Einstellungen fragt X-Sense in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| X-Sense-Konto | section | Nein | Verwende die E-Mail-Adresse und das Passwort der App X-Sense Home Security. Tipp: Lege ein zweites X-Sense-Konto an, teile dein Zuhause in der App damit und verwende es hier. Gladys ersetzt nicht die Sirenen deiner Melder. |
| E-Mail-Adresse | string | Ja | E-Mail-Adresse des X-Sense-Kontos. |
| Passwort | secret | Ja | |
| Sprache der Funktionsnamen | select | Nein | Namen der Funktionen eines neuen Geräts (Gladys behält sie nach dem Anlegen) und der Selbsttest-Ergebnisse. |
| Cloud-Leseintervall (min) | number | Nein | Alarme kommen live aus der X-Sense-Cloud. Dieses regelmäßige Lesen ist das Sicherheitsnetz und aktualisiert Batterie und Signal. |
So installierst du X-Sense in Gladys
- Öffne in Gladys Integrationen: X-Sense erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-xsense:1.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-xsense.
X-Sense benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
X-Sense ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation