X-Sense in Home Assistant einbinden und Rauchmelder, Wassermelder oder Temperatursensoren gemeinsam im Dashboard anzeigen: Das gelingt mit einer Community-Integration über HACS. Damit kannst du ausgewählte Gerätezustände überwachen und zusätzliche Benachrichtigungen erstellen. Diese Anleitung führt dich von der Vorbereitung in der X-Sense-App bis zur ersten Automation.

Die Einrichtung besteht aus zwei Teilen: Zuerst installierst du die Erweiterung über HACS. Anschließend verbindest du sie mit deinem X-Sense-Konto. Besonders wichtig sind dabei die genaue Gerätevariante und ein separates Konto für Home Assistant.

Stand der Anleitung: 2. Oktober 2026. Grundlage sind die verlinkten Projekt- und Herstellerdokumentationen. Geräteunterstützung und Menübezeichnungen können sich mit Updates ändern.

Werbung / Affiliate-Links: Die mit einem Sternchen (*) gekennzeichneten Links sind Amazon-Partnerlinks. Wenn du darüber etwas kaufst, erhalte ich möglicherweise eine Provision. Für dich entstehen dadurch keine zusätzlichen Kosten. Als Amazon-Partner verdiene ich an qualifizierten Verkäufen.

Was bringt X-Sense in Home Assistant?

Ein Wassermelder unter der Waschmaschine ist hilfreich. Noch übersichtlicher wird die Überwachung, wenn sein Zustand zusammen mit den übrigen Sensoren auf einer gemeinsamen Oberfläche erscheint. Du musst dann nicht mehrere Apps öffnen, um die eingebundenen Geräte zu kontrollieren.

Für den Einstieg bieten sich drei Anwendungen an:

  • Alarme anzeigen: Du siehst im Dashboard, welcher eingebundene Sensor einen Alarm meldet.
  • Zusätzliche Nachrichten senden: Eine Automation kann bei einer Zustandsänderung eine Nachricht an dein Smartphone schicken.
  • Wartung erleichtern: Verfügbare Batterie- und Diagnosedaten lassen sich gezielt zusammenstellen.

Die X-Sense-Community-Integration von Jarnsen stellt je nach Modell Sensoren und Bedienelemente bereit. Welche Funktionen erscheinen, hängt von den Daten und Aktionen ab, die X-Sense für das jeweilige Gerät und Konto bereitstellt.

Die zusätzlichen Automationen ersetzen weder den Melder noch dessen vorgeschriebene Prüfung. Plane Home Assistant als ergänzende Anzeige und Benachrichtigung. Eine Smartphone-Nachricht ist kein verlässlicher Ersatz für den akustischen Alarm vor Ort.

So funktioniert die Verbindung: X-Sense-Cloud statt direktem Funkzugriff

Die hier beschriebene HACS-Integration verbindet sich mit den Diensten von X-Sense. Sie liest die Geräte nicht direkt über einen Zigbee-Stick oder einen eigenen Funkempfänger aus. Ein lokal betriebener Home-Assistant-Server macht diese Verbindung deshalb nicht automatisch unabhängig vom Internet.

Der typische Datenweg lautet:

Melder → Basisstation oder WLAN → X-Sense-Cloud → Home Assistant

Die Gerätevariante entscheidet, ob eine Basisstation dazwischenliegt. Für aktuelle Zustandsänderungen nutzt die Integration Cloud-MQTT-Nachrichten. Zusätzliche Cloud-Abfragen dienen unter anderem der Anmeldung, Gerätesuche und Wiederherstellung von Zuständen. Das Projekt erläutert diese Abläufe in seiner deutschen Dokumentation.

Für diese Einrichtung musst du normalerweise keinen eigenen MQTT-Broker konfigurieren. Die Cloud-Verbindung wird durch die Integration hergestellt. Das ist von einer gesonderten, lokal eingerichteten MQTT-Anbindung zu unterscheiden.

Bei einer Störung von Internet, Cloud oder Integration können Aktualisierungen fehlen oder verspätet eintreffen. Ein zuvor angezeigter Normalzustand ist dann kein Beleg dafür, dass gerade alles in Ordnung ist. Berücksichtige deshalb neben dem Alarmzustand auch die Verfügbarkeit der Entität.

Welche X-Sense-Geräte werden unterstützt?

Die Projektliste nennt unter anderem die SBS50-Basisstation, Rauchmelder wie XS01-M und XS01-WX, CO-Melder wie XC01-M und XC04-WX, den Hitzemelder XH02-M, den Wassermelder SWS51 sowie Temperatur- und Feuchtigkeitssensoren wie STH51 und STH0A.

Weitere Gerätefamilien sind ebenfalls dokumentiert. Maßgeblich bleibt die aktuelle Liste unterstützter Geräte.

Achte auf die vollständige Modellnummer. XS01 und XS01-M sind keine austauschbaren Bezeichnungen. X-Sense unterscheidet beispielsweise eigenständige Rauchmelder, funkvernetzte Geräte und Varianten mit App-Anbindung.

Der Hersteller beschreibt den XS01-M als Gerät für die Verbindung mit der SBS50-Basisstation. Der XS01 wird dagegen als eigenständiger Rauchmelder geführt. Die Unterschiede findest du auf der X-Sense-Herstellerseite.

Ein Gerät ohne passende App- beziehungsweise Cloud-Anbindung lässt sich durch die Installation von HACS nicht nachträglich in ein kompatibles Smart-Home-Gerät verwandeln. Prüfe vor einem Kauf deshalb Modell, benötigte Basisstation und Integrationsunterstützung gemeinsam.

Passende Hardware für den Einstieg auswählen

Wenn du bereits X-Sense-Geräte besitzt, beginne mit einem vorhandenen Sensor. So kannst du zuerst prüfen, ob das Gerät erkannt wird und die benötigten Werte liefert. Zusätzliche Hardware lässt sich anschließend gezielt ergänzen.

* XSense Smart Rauchmelder XS01M mit SBS50 Basisstation

Für einen neuen Aufbau: Ein Set mit passenden Rauchmeldern und der benötigten Basisstation vermeidet, dass beim ersten Einrichten ein Baustein fehlt. Kontrolliere den Lieferumfang; ähnlich benannte Angebote können ausschließlich zusätzliche Melder enthalten.

* XSense WiFi Wassermelder mit Batterie Wassersensor IP66

Für die Überwachung von Wasser: Ein unterstützter Wassermelder kann eine sinnvolle Ergänzung unter Waschmaschine oder Spüle sein. Prüfe, ob deine vorhandene Basisstation zum ausgewählten Modell passt.

* XSense WLAN Hygrometer Thermometer Innen

* XSense WLAN Thermometer Hygrometer Innen, Raumthermometer

Für Temperatur und Luftfeuchtigkeit: Wähle einen unterstützten Sensor, dessen Messwerte du tatsächlich für eine Anzeige oder Automation verwenden möchtest. Ein zusätzlicher Sensor lohnt sich besonders dort, wo bislang keine passenden Daten vorhanden sind.

Vorbereitung: Home Assistant, HACS und X-Sense prüfen

Bevor du X-Sense in Home Assistant einrichtest, solltest du folgende Punkte erledigen:

  • Home Assistant läuft und du kannst Integrationen verwalten.
  • HACS ist eingerichtet und lässt sich öffnen.
  • Die X-Sense-Geräte sind in der Home-Security-App eingerichtet und erreichbar.
  • Home Assistant hat eine funktionierende Internetverbindung.
  • Ein aktuelles Backup ist vorhanden.

Wenn HACS noch fehlt, findest du auf IT-Fundus die Anleitung HACS installieren und einrichten. Für eine neue Zentrale hilft zusätzlich der Beitrag Die ersten Schritte nach der Home-Assistant-Installation.

Erstelle das Backup vor der Änderung und stelle sicher, dass du es im Fehlerfall wiederherstellen kannst. Der Artikel Home Assistant: Backup und Wiederherstellung beschreibt diesen Ablauf ausführlich.

Ein separates X-Sense-Konto anlegen

Das Projekt empfiehlt ein zweites X-Sense-Konto für Home Assistant. Gemeinsame Zugangsdaten für App und Integration können zu konkurrierenden Sitzungen und erneuten Anmeldungen führen.

Teile die unterstützten Geräte vom Hauptkonto mit dem zweiten Konto und verwende dessen Zugangsdaten für Home Assistant. Die Verwaltung bleibt beim Hauptkonto.

Kontrolliere vor der Einrichtung, ob die freigegebenen Geräte im zweiten Konto sichtbar sind. Fehlt dort bereits ein Sensor, beginne bei der Freigabe in der App. Eine erneute HACS-Installation löst dieses Problem nicht.

X-Sense in Home Assistant über HACS installieren

Diese Anleitung verwendet das Repository Jarnsen/ha-xsense-component_test. Trotz des Namensbestandteils „test“ ist dies das hier dokumentierte Community-Projekt. Verwende die vollständige Adresse, damit du nicht versehentlich eine andere Erweiterung auswählst.

1. Benutzerdefiniertes Repository hinzufügen

  1. Öffne HACS in Home Assistant.
  2. Öffne oben rechts das Drei-Punkte-Menü.
  3. Wähle Benutzerdefinierte Repositories beziehungsweise Custom repositories.
  4. Trage die folgende Repository-Adresse ein.
  5. Wähle als Typ Integration und füge den Eintrag hinzu.
https://github.com/Jarnsen/ha-xsense-component_test

Diese Vorgehensweise entspricht der HACS-Anleitung für benutzerdefinierte Repositories. Die genaue Beschriftung kann je nach Sprache und HACS-Version abweichen.

2. Erweiterung herunterladen und Home Assistant neu starten

Suche in HACS nach X-Sense, öffne den Eintrag des hinzugefügten Repositories und lade die aktuelle kompatible Version herunter. Starte danach Home Assistant vollständig neu. Ein Neuladen des Dashboards reicht nicht, um neu installierten Integrationscode zu laden.

HACS übernimmt hier die Installation der Dateien. Die Verbindung zu deinem X-Sense-Konto richtest du im nächsten Schritt ein.

3. X-Sense-Konto verbinden

Öffne Einstellungen → Geräte & Dienste → Integration hinzufügen. Suche nach X-Sense und wähle die installierte Integration. Melde dich mit dem zuvor vorbereiteten zweiten X-Sense-Konto an. Nach der Einrichtung kontrollierst du die erkannten Geräte.

Wenn der Eintrag nicht erscheint, prüfe zuerst den abgeschlossenen Download und den Neustart. Installiere nicht gleichzeitig mehrere X-Sense-Erweiterungen: Die Fehlersuche wird dadurch unnötig unübersichtlich.

Geräte und Entitäten sinnvoll ordnen

Ein Gerät kann mehrere Entitäten besitzen. Die Entität ist jeweils ein einzelner Wert oder eine Funktion: beispielsweise ein Alarmzustand, eine Temperatur oder eine Schaltfläche.

Gehe nach der Einrichtung jedes Gerät durch und notiere, welche Entität du für welchen Zweck benötigst.

Je nach Modell stellt das Projekt Alarmzustände, Batterie- und Signalwerte, Temperatur, Luftfeuchtigkeit, CO-Daten sowie unterstützte Test- oder Stummschaltaktionen bereit. Ein fehlender Batteriewert bedeutet deshalb nicht automatisch, dass die gesamte Integration falsch eingerichtet ist. Das Gerät muss das entsprechende Feld liefern. Die Funktionsübersicht des Projekts beschreibt diese Einschränkung.

Vergib verständliche Namen wie „Rauchmelder Flur“ und „Wassermelder Waschmaschine“. Ordne die Geräte außerdem dem richtigen Bereich zu. Dadurch lässt sich später eine Meldung schneller zuordnen als mit einer Seriennummer.

Ein übersichtliches X-Sense-Dashboard erstellen

Beginne mit einer einfachen Entitätenkarte. Sie sollte die wichtigsten Alarmzustände und einige relevante Messwerte zeigen. Diagnosewerte kannst du in eine zweite Karte verschieben. So bleibt die Hauptansicht auch auf einem Smartphone lesbar.

Die Home-Assistant-Dokumentation zur Entitätenkarte erläutert die verfügbaren Einstellungen.

Verzichte in der Hauptansicht auf leicht versehentlich bedienbare Schaltflächen für Stummschaltung oder Alarmänderungen. Eine gute Übersicht beantwortet zuerst zwei Fragen: Welches Gerät meldet etwas, und sind seine Daten verfügbar?

Automation: Bei einem Wasseralarm eine Nachricht senden

Für die erste Automation eignet sich eine klare Aufgabe: Sobald ein Wassermelder Alarm meldet, soll dein Smartphone eine zusätzliche Nachricht erhalten.

Richte dafür die Home Assistant Companion App ein und prüfe zunächst den Benachrichtigungsdienst. Die Dokumentation zu Companion-Benachrichtigungen erklärt die Einrichtung.

Öffne Einstellungen → Automationen & Szenen, erstelle eine neue Automation und wechsle über das Menü zum YAML-Editor.

Das folgende Beispiel ist eine vollständige einzelne Automation für diesen Editor; es gehört nicht unverändert in die configuration.yaml. Wie du zwischen den Ansichten wechselst, zeigt die Anleitung zum Automationseditor.

alias: "X-Sense: Wasseralarm melden"
description: "Zusätzliche Smartphone-Nachricht bei erkanntem Wasser"
triggers:
  - trigger: state
    entity_id: binary_sensor.wassermelder_waschmaschine
    to: "on"
conditions: []
actions:
  - action: notify.mobile_app_dein_smartphone
    data:
      title: "Wasseralarm"
      message: "Der Wassermelder an der Waschmaschine meldet Wasser."
mode: single

Ersetze beide Beispielnamen: binary_sensor.wassermelder_waschmaschine muss die tatsächliche Alarm-Entität sein. notify.mobile_app_dein_smartphone muss zu deinem registrierten Smartphone passen.

Der interne Zustand on ist nicht mit dem übersetzten Anzeigetext zu verwechseln. Prüfe den echten Zustand unter Entwicklerwerkzeuge → Zustände.

Der Auslöser reagiert auf einen Wechsel nach on; dazu kann auch die Wiederkehr eines zuvor nicht verfügbaren Sensors mit aktivem Alarm gehören. Einzelheiten zu Zustandsauslösern findest du in der Home-Assistant-Dokumentation.

Rauch- und CO-Meldungen getrennt behandeln

Dasselbe Grundprinzip kannst du für eine vorhandene Rauch- oder CO-Alarm-Entität verwenden: Wähle die passende Entität und formuliere eine eindeutige Nachricht mit Gerätetyp und Raum. Verlasse dich nicht auf einen ähnlich klingenden Diagnosesensor.

Plane eine Alarmbenachrichtigung ohne Bedingung „nur wenn niemand zu Hause ist“. Auch eine anwesende Person kann eine ergänzende Nachricht gebrauchen. Vermeide außerdem eine automatische Stummschaltung. Die Automation soll auf einen gemeldeten Zustand aufmerksam machen.

Eine normale Push-Nachricht kann durch die Einstellungen des Smartphones stumm bleiben. Falls du besondere Benachrichtigungsoptionen benötigst, prüfe sie für dein Betriebssystem und teste das tatsächliche Verhalten. Der Beispielcode garantiert keine hörbare Meldung bei aktivem Ruhemodus.

Einrichtung und Benachrichtigungen richtig testen

Teste die einzelnen Teile getrennt. So erkennst du, wo ein Fehler liegt, bevor du weitere Geräte und Aktionen ergänzt.

  1. Nachricht prüfen: Führe zuerst nur die Benachrichtigungsaktion aus. Kommt sie auf dem richtigen Smartphone an?
  2. Entität prüfen: Kontrolliere, ob du tatsächlich den Alarmzustand des gewünschten Geräts ausgewählt hast.
  3. Übertragung prüfen: Verwende ausschließlich die vom Hersteller vorgesehene Testfunktion und beobachte App sowie Home Assistant. Ein Testsignal muss nicht denselben Cloud-Zustand erzeugen wie ein echter Alarm.
  4. Automation prüfen: Sieh dir nach einem passenden Zustandswechsel die Ablaufverfolgung der Automation an.
  5. Neustart prüfen: Kontrolliere nach einem Neustart, ob die Geräte wieder verfügbar sind.

„Aktionen ausführen“ prüft die Aktionen einer Automation, aber nicht den kompletten Weg vom Sensor bis zum Auslöser. Notiere deshalb getrennt, ob die Nachricht funktioniert und ob der passende Zustand tatsächlich in Home Assistant ankommt.

Für Rauch- und CO-Melder hältst du dich an die Herstelleranleitung; erzeuge keine gefährliche Situation zum Testen.

Häufige Probleme bei X-Sense und HACS lösen

Die Anmeldung funktioniert nicht

Prüfe zuerst das zweite Konto in der X-Sense-App. Stimmen E-Mail-Adresse und Passwort? Ist das Konto vollständig eingerichtet? Werden die freigegebenen Geräte angezeigt? Wenn diese Grundlage nicht funktioniert, lohnt sich die Fehlersuche in Home Assistant noch nicht.

Bei wiederkehrenden Abmeldungen kontrollierst du, ob Home Assistant versehentlich die Zugangsdaten des Hauptkontos verwendet. Danach helfen die Home-Assistant-Protokolle, den Fehler genauer einzugrenzen.

Ein Gerät wird nicht angezeigt oder Messwerte fehlen

Vergleiche Modellnummer, Gerätefreigabe und App-Anzeige. Fehlt das Gerät im zweiten Konto, korrigiere die Freigabe. Ist es dort sichtbar, überprüfe die Unterstützung in der Projektdokumentation.

Wenn nur ein einzelner Wert fehlt, notiere genau, welcher Wert das ist und ob die App ihn überhaupt anzeigt.

Für eine nachvollziehbare Fehlermeldung sind Modell, Integrationsversion und Home-Assistant-Version hilfreicher als die Aussage „geht nicht“. Entferne Zugangsdaten und persönliche Informationen aus Protokollen, bevor du sie weitergibst.

Der Zustand bleibt unverändert oder die Entität ist nicht verfügbar

Vergleiche zuerst die Anzeige in der X-Sense-App. Ist auch dort das Gerät offline, beginne bei Gerät, Basisstation oder Netzwerk. Zeigt die App aktuelle Daten, während Home Assistant unverändert bleibt, prüfe die Integration und ihre Protokolle unter Einstellungen → System → Protokolle.

Ein dauerhaft sichtbarer Normalzustand und eine tatsächlich funktionierende Verbindung sind zwei verschiedene Beobachtungen. Nimm fehlende Aktualisierungen deshalb ernst und überprüfe die gesamte Übertragungskette.

Nach einem Update startet die Integration nicht mehr

Das Projekt dokumentiert eine konkrete Versionsgrenze: Wer noch eine alte v1.2.6.x-Version verwendet, soll vor dem Wechsel auf Home Assistant Core 2026.7 oder neuer mindestens auf v1.3.14 aktualisieren.

Hintergrund ist eine alte Abhängigkeit von aiortc, die mit der neueren Python-Laufzeit nicht kompatibel ist. Beachte dafür die aktuellen Update-Hinweise.

Fehlt ein erwartetes Update, öffne das X-Sense-Repository in HACS und verwende im Menü Informationen aktualisieren beziehungsweise Update information. Aktualisiere anschließend die Integration und starte Home Assistant neu.

Prüfe danach auch Dashboard und Automationen. Die Hinweise zu Entitätsänderungen helfen, geänderte Zuordnungen zu erkennen.

X-Sense mit weiteren Geräten kombinieren

Wenn die Sensoren zuverlässig angezeigt werden und die erste Nachricht funktioniert, kannst du ergänzende Aktionen planen. Beispielsweise kann eine bereits eingebundene Lampe zusätzlich auf eine Meldung aufmerksam machen. Teste zuerst die Lampensteuerung allein und erweitere anschließend die Automation.

Für passende Aktoren findest du auf IT-Fundus die Anleitung Shelly in Home Assistant einbinden. Beachte dabei: Ein lokal steuerbarer Aktor ändert nichts an der Cloud-Abhängigkeit des X-Sense-Auslösers.

Beginne mit wenigen, verständlichen Regeln. Eine klare Nachricht mit Raumangabe hilft bei der Zuordnung. Eine lange Liste gleichzeitiger Aktionen ist dagegen schwieriger zu prüfen und zu warten.

Häufige Fragen zu X-Sense in Home Assistant

Ist die hier beschriebene X-Sense-Integration eine Core-Integration?

Diese Anleitung verwendet eine Community-Erweiterung, die du als benutzerdefiniertes Repository über HACS installierst. Prüfe deren Dokumentation und Updates zusätzlich zu den Home-Assistant-Updates.

Brauche ich immer eine SBS50-Basisstation?

Das hängt vom exakten Modell ab. Manche Geräte verwenden eine passende Basisstation, andere besitzen eine direkte WLAN-Anbindung. Entscheidend sind die Herstellerangaben und die Unterstützung durch die Integration.

Kann ich jeden X-Sense-Rauchmelder einbinden?

Nein. Die Marke allein reicht nicht als Kompatibilitätsnachweis. Prüfe die genaue Modellnummer, die App-Anbindung und die aktuelle Projektliste.

Funktioniert diese HACS-Anbindung ohne Internet?

Für die hier beschriebene Cloud-Anbindung wird Internet benötigt. Bei einer Unterbrechung solltest du keine aktuellen Daten oder zusätzlichen Home-Assistant-Benachrichtigungen erwarten.

Muss ich Geräte erneut in Home Assistant koppeln?

Die Geräte werden zunächst in der X-Sense-App eingerichtet. Home Assistant greift anschließend über die Integration auf das vorbereitete Konto zu. Prüfe daher die App-Einrichtung, bevor du in Home Assistant nach einem fehlenden Gerät suchst.

Ein guter Einstieg: Ein Sensor, eine klare Nachricht

X-Sense in Home Assistant bietet eine gemeinsame Übersicht und zusätzliche Automationen für unterstützte Geräte. Für eine nachvollziehbare Einrichtung gehst du in dieser Reihenfolge vor: Modell prüfen, App einrichten, separates Konto vorbereiten, HACS-Integration installieren und anschließend die benötigten Entitäten kontrollieren.

Beginne mit einem Sensor und einer Benachrichtigung. Sobald du den Datenweg geprüft hast, ergänzt du weitere Geräte und Dashboard-Anzeigen. So entsteht eine übersichtliche Erweiterung deines Smart Homes, deren Möglichkeiten und Grenzen du kennst.