Zum Hauptinhalt springen

Sector Alarm Smart-Home-Integration, kostenlos und Open Source

Sector Alarm-Integration für Gladys Assistant

Schalte deine Sector-Alarm-Anlage scharf/unscharf, steuere Schlösser, Steckdosen, Sensoren.

Diese Integration verbindet Gladys mit deiner Sector-Alarm-Alarmanlage: die Zentrale scharf und unscharf schalten, die smarten Schlösser ver- und entriegeln, die smarten Steckdosen schalten und den Sensoren folgen (Türen und Fenster, Rauch, Wasserlecks, Temperatur, Luftfeuchtigkeit).

Bevor du beginnst​

  • Gladys 5.3 oder neuer ist erforderlich.
  • Ein Sector-Alarm-Konto: die E-Mail-Adresse und das Passwort der Sector-Alarm-App.
  • Gladys braucht Internetzugang. Sector Alarm hat keine lokale API: Alles läuft über die Sector-Alarm-Cloud (mypagesapi.sectoralarm.net). Deshalb trägt die Integration das Tag cloud.

Konfiguration​

FeldWas eintragen
E-MailDie E-Mail-Adresse deines Sector-Alarm-Kontos.
PasswortSein Passwort. Als Geheimnis gespeichert, nie in die Protokolle geschrieben.
Code der ZentraleDer Code, den du am Bedienteil eingibst. Optional, siehe unten.
ID der ZentraleLeer, um allen Zentralen des Kontos zu folgen. Sonst eine ID oder mehrere, durch Kommas getrennt.
Aktualisierungsintervall (s)Wie oft Sector Alarm gelesen wird. Standard 60 s, mindestens 30 s. Sector Alarm begrenzt Anfragen: Unter einer Minute bringt es wenig.

Speichere und klicke dann auf Verbindung testen: Die Antwort listet die gefundenen Zentralen, ihren Modus, ob sie online sind und wie viel Zubehör sie haben. Öffne danach den Reiter Geräteerkennung der Integration und lege die gewünschten Geräte an.

Der Code der Zentrale​

Der Code wird nur benötigt, um:

  • den Alarm aus Gladys unscharf zu schalten (eine Szene, die Gerätekarte);
  • ein smartes Schloss zu ver- oder entriegeln;
  • eine Zentrale scharf zu schalten, deren Schnellaktivierung ausgeschaltet ist.

Ohne Code kann Gladys trotzdem alles lesen und eine Zentrale mit Schnellaktivierung scharf schalten. Lass ihn leer, wenn Gladys nicht unscharf schalten können soll.

Geräte​

Gerät in GladysFunktionenWerte
Zentrale (eine pro Zentrale)Alarmmodus (eine Liste: Unscharf, Teilweise scharf, Scharf)disarmed, partial, armed
Smartes SchlossSchloss (steuerbar), Batterie schwach1 = verriegelt, 0 = entriegelt
Smarte SteckdoseStrom (steuerbar)1 = an, 0 = aus
Tür-/FenstersensorÖffnung, Batterie schwach1 = geschlossen, 0 = offen
RauchmelderRauch, oft Temperatur1 = Rauch erkannt
WassermelderWasserleck1 = Leck erkannt
Temperatur / LuftfeuchtigkeitTemperatur (°C), Luftfeuchtigkeit (%)

„Teilweise scharf“ erscheint nur bei einer Zentrale, die es kann. Jedes Gerät zeigt ein cloud-Abzeichen; es wechselt auf nicht erreichbar, wenn die Zentrale offline ist oder Sector Alarm nicht antwortet.

Gladys fragt die Geräte nicht einzeln ab: Die Integration liest jede Zentrale als Ganzes, im gewählten Intervall, und schickt Gladys nur die geänderten Werte. Nach einem Befehl wird die Zentrale einige Sekunden später erneut gelesen, um ihn zu bestätigen.

Dashboard-Widget​

Füge das Widget Sector Alarm einem Dashboard hinzu. Es zeigt:

  • den Alarmmodus (rot scharf, orange teilweise scharf, grün unscharf);
  • die Verbindung der Zentrale;
  • offene Türen und Fenster, entriegelte Schlösser;
  • eine Rauch- oder Wasserwarnung.

Seine Schaltflächen: Scharf schalten und Teilweise (mit Bestätigung), Unscharf schalten, Aktualisieren.

Sicherheit. Ein Dashboard kann an der Wand hängen, und jeder kann darauf tippen. Die Schaltfläche Unscharf schalten verwendet daher nie den Code der Konfiguration: Sie öffnet ein kleines Formular, in das der Code jedes Mal eingegeben werden muss.

Bei mehreren Zentralen wählst du die anzuzeigende in den Widget-Einstellungen.

Szenen​

Auslöser​

AuslöserSchlüsselFilterVariablen
Der Alarmmodus ändert sichalarm_mode_changedZentrale, Neuer Modusmode, previous_mode, panel_name, user, channel
Eine Zentrale geht offline oder kommt zurückpanel_connection_changedZentrale, Verbindungstate (offline / online), panel_name
Ein smartes Schloss wird betätigtlock_operatedSchloss, Was passiert istaction (lock / unlock / lock_failed), lock_name, user, channel

user und channel stammen aus dem Ereignisprotokoll von Sector Alarm (wer, und womit: Bedienteil, App, Tag…); sie sind leer, wenn das Protokoll es nicht sagt.

Die Auslöser reagieren auf Änderungen zwischen zwei Lesevorgängen, egal woher sie kommen (Bedienteil, App, Tag oder Gladys). Beim ersten Lesen nach einem Start wird nichts ausgelöst: Die Historie ist keine Neuigkeit. Eine Änderung, die zwischen zwei Lesevorgängen kommt und wieder geht, kann übersehen werden: Verringere das Intervall, wenn das wichtig ist.

Beispiele:

  • Wenn der Alarm unscharf geschaltet wird und niemand zu Hause ist, schicke mir eine Benachrichtigung mit {{triggerEvent.data.user}}.
  • Wenn die Zentrale offline geht, sende eine Nachricht.
  • Wenn die Haustür entriegelt wird, schalte das Licht im Flur ein.

Aktionen​

AktionSchlüsselFelderAusgaben
Alarmmodus setzenset_alarm_modeZentrale, Modusapplied (ja/nein), mode, error
Sector Alarm jetzt lesenrefresh_nowZentrale (optional)mode, online

set_alarm_mode verwendet den Code der Zentrale aus der Konfiguration. Ein abgelehnter Befehl hält die Szene nicht an: Prüfe applied in einer Bedingung und verwende error in einer Benachrichtigung. Beispiel: Um 23 Uhr den Alarm teilweise scharf schalten; wenn applied nein ist, schicke mir error.

Die Standardaktionen von Gladys steuern die Geräte ebenfalls: Alarmmodus, Schlösser und Steckdosen lassen sich mit Gerät steuern setzen.

Schaltflächen der Konfigurationsseite​

  • Verbindung testen: meldet sich neu an und liest jede Zentrale.
  • Jetzt aktualisieren: liest Sector Alarm sofort.

Fehlerbehebung​

Was du siehstWas zu tun ist
„Sector Alarm lehnt E-Mail oder Passwort ab“Prüfe sie in der Sector-Alarm-App und speichere erneut.
„Sector Alarm bittet um weniger Anfragen“Sector Alarm begrenzt Anfragen. Die Integration liest seltener und kehrt dann zum Normalbetrieb zurück. Erhöhe das Intervall.
„Sector Alarm ist nicht erreichbar“Prüfe den Internetzugang von Gladys.
„Der Code der Zentrale wird benötigt…“Trage den Code ein oder schalte nur mit Schnellaktivierung scharf.
Ein Sensor fehltKlicke auf Jetzt aktualisieren und sieh im Reiter Geräteerkennung nach: Neues Zubehör erscheint dort.
Der Modus bleibt während eines Ausfalls stehenGewollt: Eine Zentrale meldet sich offline immer als „scharf“, Gladys behält daher den letzten bekannten Modus.

Datenschutz​

Deine E-Mail-Adresse, dein Passwort und dein Code bleiben in Gladys, als Geheimnisse, und werden nur an Sector Alarm (mypagesapi.sectoralarm.net) gesendet. Die Integration nutzt keinen anderen Dienst.

Diese Integration wird von Sector Alarm weder erstellt noch unterstützt. Sie verwendet dieselbe API wie die Sector-Alarm-App, die sich ohne Vorankündigung ändern kann.

Konfigurationseinstellungen​

Diese Einstellungen fragt Sector Alarm in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Erste SchrittesectionNeinSector Alarm hat keine lokale API: Die Integration spricht mit der Sector-Alarm-Cloud, mit dem Konto der Sector-Alarm-App. Gib dessen E-Mail-Adresse und Passwort ein; die Zentralen, Schlösser, Steckdosen und Sensoren des Kontos erscheinen dann in der Geräteerkennung. Der Code der Zentrale wird nur zum Unscharfschalten, für die Schlösser und zum Scharfschalten einer Zentrale ohne Schnellaktivierung benötigt.
E-MailstringJaDie E-Mail-Adresse, mit der du dich in der Sector-Alarm-App anmeldest.
PasswortsecretJaDas Passwort dieses Sector-Alarm-Kontos. Es wird nie in die Protokolle geschrieben.
Code der ZentralesecretNeinDer Code, den du am Bedienteil eingibst. Nötig, um aus Gladys unscharf zu schalten, eine Tür zu ver- oder entriegeln und eine Zentrale ohne Schnellaktivierung scharf zu schalten. Leer gelassen kann Gladys nur scharf schalten (mit Schnellaktivierung). Das Dashboard-Widget verwendet ihn nie zum Unscharfschalten: Es fragt jedes Mal nach dem Code.
ID der ZentralestringNeinLeer lassen, um allen Zentralen des Kontos zu folgen. Um nur einigen zu folgen, gib ihre IDs durch Kommas getrennt ein: „Verbindung testen“ listet sie auf.
Aktualisierungsintervall (s)numberNeinWie oft die Sector-Alarm-Cloud gelesen wird, in Sekunden (mindestens 30). Sector Alarm begrenzt die Anzahl der Anfragen: Unter einer Minute bringt es wenig und riskiert eine Drosselung.

So installierst du Sector Alarm in Gladys​

  1. Öffne in Gladys Integrationen: Sector Alarm erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/prohand/gladys-sectoralarm:1.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/prohand/gladys-sectoralarm.

Sector Alarm benötigt Gladys >=5.3.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​

Sector Alarm 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 prohand veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂