In diesem Beispiel lernst du, wie deine DoorBird-Türsprechanlage beim Klingeln einen WebRequest an deinen Gira X1 sendet. Damit kannst du z. B. ein Licht einschalten, einen Gong über KNX auslösen, eine Nachricht aufzeichnen oder ein Bild der Kamera speichern.

Schritt 1: HTTP-Aufruf in der DoorBird App anlegen

  1. Öffne die DoorBird App und melde dich in den Einstellungen unter „Administration“ mit dem Administrator-Zugang deiner DoorBird an.
  2. Öffne „Favoriten“ und lege unter „HTTP(S)-Aufrufe“ einen neuen Eintrag an.
  3. Vergib einen Namen, z. B. „Gira X1 Klingel“, und trage als Adresse ein:
    http://<ip-gira-x1>:8081/virtual/doorbird-klingel
  4. Speichere den Favoriten.

Schritt 2: Aufruf dem Klingeln zuordnen

  1. Öffne in der Administration den Zeitplan für die Türklingel.
  2. Wähle als Aktion den HTTP(S)-Aufruf „Gira X1 Klingel“ und aktiviere ihn für alle Zeiten, zu denen er ausgelöst werden soll (z. B. rund um die Uhr).
  3. Speichere die Einstellungen.

Die genauen Bezeichnungen können je nach Version der DoorBird App leicht abweichen. Details findest du in der Anleitung deiner DoorBird.

Tipp: Auf die gleiche Weise kannst du auch den Bewegungssensor der DoorBird nutzen. Lege dafür einen zweiten HTTP-Aufruf an, z. B. …/virtual/doorbird-bewegung, und ordne ihn dem Zeitplan des Bewegungssensors zu.

Schritt 3: WebRequest in der Logik auswerten

  1. Füge im Logikeditor des GPA einen Baustein „XTENSION Nodes: WebRequest prüfen“ hinzu und verbinde seinen Eingang „Komplette Anfrage“ mit dem gleichnamigen Ausgang des Grundbausteins.
  2. Trage als „Erwartete WebRequest-Ressource“ den Wert doorbird-klingel ein.
  3. Verwende den Ausgang „Treffender WebRequest Datum / Uhrzeit“ als Auslöser: Er ändert sich bei jedem Klingeln. Daraus kannst du z. B. mit einem Treppenlicht- oder Impulsbaustein das Flurlicht für zwei Minuten einschalten oder einen Gong über KNX auslösen.
  4. Nimm das Projekt in Betrieb.

Schritt 4: Testen

Rufe zuerst die Adresse http://<ip-gira-x1>:8081/virtual/doorbird-klingel im Browser auf. Funktioniert die Logik, drücke die Klingel an der DoorBird. Im Register „Diagnose“ siehst du jede empfangene Anfrage.

Erweiterungen des Beispiels

  • Klingeln protokollieren: Verbinde den Auslöser mit einem Baustein „Nachricht aufzeichnen“ (Text „Es hat geklingelt“, Kategorie „Haustür“). Die Nachrichten siehst du im Nachrichtenverlauf.
  • Bild speichern: Mit dem Baustein „Bild aufzeichnen“ speicherst du bei jedem Klingeln ein Standbild der DoorBird-Kamera auf der Micro-SD-Karte. Die Adresse für ein Standbild findest du in der Schnittstellenbeschreibung (API) der DoorBird; sie benötigt in der Regel Benutzername und Passwort eines DoorBird-Benutzers.