DoorLine Cam / Snap modular

Verwendung eines Shelly Schalt-Aktors

In diesem Artikel wird beschrieben, wie die DoorLine Snap zusammen mit einem Shelly WLAN-Schalt-Aktor verwendet werden kann. Dadurch müssen nicht zwingend die Relaiskontakte der DoorLine Snap genutzt werden. Der Shelly kann unabhängig von der DoorLine Snap dort platziert werden, wo er benötigt wird, z. B. im Hausinneren. So kann auch ein Türöffner angesteuert werden, dessen Kontakte innen liegen und nicht bis zur DoorLine Snap verdrahtet werden können. Da die Ansteuerung von innen erfolgt, kann der Türöffner auch bei einer abgebauten DoorLine Snap nicht von außen geschaltet werden.

Wird am FRITZ!Fon bzw. Smartphone die Türöffnerfunktion gewählt oder die Klingeltaste gedrückt, ruft die DoorLine Snap eine HTTP-Adresse (URL) des Shelly auf. Der Shelly schaltet daraufhin seinen Ausgang für eine festgelegte Zeit ein. Es wird dafür nur die DoorLine Snap, der Shelly und ein WLAN benötigt. Ein Smart-Home-System, eine Cloud oder ein Herstellerkonto sind nicht erforderlich.

Typische Anwendungen:

  • Türöffner: Der Shelly schaltet einen innenliegenden Türöffner, sobald am Telefon Tür öffnen gewählt wird.

  • Türgong: Beim Drücken der Klingeltaste schaltet der Shelly einen Gong.

  • Licht: Beim Klingeln schaltet der Shelly für eine bestimmte Zeit ein Außen- oder Flurlicht ein.

Achtung: Arbeiten an Netzspannung (230 V) dürfen nur von einer Elektrofachkraft durchgeführt werden. Türöffner werden in der Regel mit Kleinspannung (z. B. 8–12 V AC/DC) betrieben. Die Angaben des Herstellers zu Spannung und Strom des Shelly-Kontakts beachten.

Voraussetzungen

  • Installierte und eingerichtete DoorLine Snap mit Firmware 1.4 oder höher

  • Eingerichtete Türsprechanlage in der FRITZ!Box → siehe hierzu: Inbetriebnahme / Konfiguration | Dokumentation DoorLine

  • Ein Shelly Schalt-Aktor mit potenzialfreiem Kontakt, z. B. Shelly Plus 1 oder Shelly 1 Gen3

  • Ein Netzteil 12 V DC für den Shelly

  • Eine separate Versorgung für den Türöffner, z. B. Klingeltrafo oder Netzteil passend zum Türöffner

  • Ein 2,4-GHz-WLAN, in dem sowohl die DoorLine Snap als auch der Shelly angemeldet sind

  • Ein Endgerät mit Webbrowser, z. B. Smartphone, Tablet oder PC

Funktionsweise im Überblick

Funktionsweise_DoorLine_Snap_Shelly_v2.svg
  • Klingeln: Ein Besucher drückt die Klingeltaste. Die DoorLine Snap ruft über die FRITZ!Box die eingestellten Telefone an.

  • Tür öffnen: Nach der Rufannahme wird am FRITZ!Fon der Softkey Tür öffnen gedrückt bzw. am Smartphone oder einem anderen Telefon der Türöffner-Code eingegeben.

  • HTTP-Request: Ist ein Auslöser mit dem passenden Ereignis eingerichtet, ruft die DoorLine Snap die hinterlegte URL des Shelly auf.

  • Schalten: Der Shelly schaltet seinen Ausgang für die in timer angegebene Zeit ein und danach wieder aus.

  • Unabhängige Platzierung: Der Shelly wird über das WLAN geschaltet und benötigt keine Leitung zur DoorLine Snap. Er kann direkt am Türöffner oder im Verteiler sitzen.

  • Sicherheit durch Auto off: Mit aktiviertem Auto off schaltet der Shelly in jedem Fall selbstständig wieder aus.

  • Rein lokal: Der Aufruf erfolgt direkt im Heimnetz. Es wird keine Internetverbindung benötigt.

1. Shelly anschließen

Der Shelly wird über die Klemmen 12V (+) und L (−) mit 12 V DC versorgt. Der Kontakt zwischen den Klemmen I und O ist potenzialfrei. Er wird wie ein Taster in den Stromkreis des Türöffners geschaltet.

Klemme

Anschluss

12V

+ des Netzteils für den Shelly (12 V DC)

L

− des Netzteils für den Shelly

I

Versorgung des Türöffners (Klingeltrafo bzw. + des Netzteils für den Türöffner)

O

Türöffner

N, SW

nicht belegt

Anschlussplan_Shelly_Tueroeffner_2.svg

Hinweis: Bei 12 V DC ist die Klemme L der Minuspol (⊥) und die Klemme N bleibt frei. Die Belegung ist auf dem Shelly aufgedruckt (gestrichelter Rahmen „DC 12V“).

A – Türöffner mit Klingeltrafo (AC)

Ein Anschluss des Klingeltrafos wird an I angeschlossen, O geht zum Türöffner. Der zweite Anschluss des Türöffners geht direkt zurück zum Klingeltrafo.

B – Türöffner mit Gleichspannung (DC)

Der Pluspol plus des Netzteils für den Türöffner wird an I angeschlossen, O geht an + des Türöffners. − des Türöffners geht direkt an − des Netzteils für den Türöffner.

In beiden Fällen wird der Shelly über ein eigenes Netzteil mit 12 V DC versorgt. Da der Kontakt I–O potenzialfrei ist, sind die beiden Stromkreise voneinander getrennt.

Hinweis: Shelly und Türöffner über getrennte Netzteile versorgen. Türöffner ziehen beim Einschalten kurzzeitig einen hohen Strom und erzeugen beim Abschalten Spannungsspitzen. Bei einem gemeinsamen Netzteil kann die Spannung dadurch kurz einbrechen und der Shelly neu starten. Der Türöffner wird dann nicht oder nur kurz angesteuert.

Hinweis: Ist bereits ein Türöffner-Taster vorhanden, kann der Shelly-Kontakt I–O parallel dazu angeschlossen werden. Der Taster funktioniert dann weiterhin.

Hinweis: Die Klemmenbezeichnungen gelten für den Shelly Plus 1. Bei anderen Modellen die Anschlussbelegung in der Anleitung des Herstellers prüfen.

2. Shelly einrichten

Einbindung ins WLAN

Nach dem Einschalten öffnet der Shelly ein eigenes WLAN (z. B. ShellyPlus1-…). Nach dem Verbinden mit diesem WLAN ist die Weboberfläche des Shelly unter http://192.168.33.1 erreichbar. Dort unter WLAN bzw. Wi-Fi das eigene WLAN und das Passwort eintragen. Alternativ kann der Shelly über die App Shelly Smart Control eingerichtet werden.

Feste IP-Adresse vergeben

Die DoorLine Snap ruft den Shelly über seine IP-Adresse auf. Damit sich diese Adresse nicht ändert, im Router eine feste IP-Adresse für den Shelly vergeben, z. B. bei einer FRITZ!Box unter Heimnetz > Netzwerk > Netzwerkverbindungen > Shelly bearbeiten > Diesem Netzwerkgerät immer die gleiche IPv4-Adresse zuweisen.

Die IP-Adresse des Shelly notieren. In dieser Anleitung wird als Beispiel 192.168.178.35 verwendet.

Automatische Abschaltung (empfohlen)

In der Weboberfläche des Shelly unter Home auf den Ausgang Output (0) klicken. Im Bereich Automations den Reiter Timers öffnen, Auto off aktivieren und die Zeit eintragen, z. B. 3 Sekunden. Anschließend auf Save klicken.

Der Shelly schaltet dann nach dem Einschalten immer von selbst wieder aus. Der Türöffner bleibt dadurch nie dauerhaft geschaltet, auch wenn die URL versehentlich ohne Zeitangabe aufgerufen wird.

image-20261014-115216.png

Hinweis: Auto off gilt für jedes Einschalten des Ausgangs, also auch beim Schalten über die App oder den Schalteingang SW des Shelly. Wird der Shelly für ein Licht verwendet, das auch dauerhaft eingeschaltet werden soll, Auto off nicht aktivieren und die Zeit nur über timer in der URL festlegen.

Hinweis: Die Bezeichnungen in der Weboberfläche können je nach Shelly-Modell und Firmware abweichen.

Hinweis: In der Weboberfläche des Shelly kein Passwort (Authentication) aktivieren. Ist ein Passwort gesetzt, wird der Aufruf der DoorLine Snap vom Shelly abgelehnt.

3. URL des Shelly ermitteln

Der Shelly wird über eine einfache URL geschaltet. Die URL setzt sich aus der IP-Adresse des Shelly und dem Befehl zusammen:

Funktion

URL (Beispiel)

Einschalten

http://192.168.178.35/relay/0?turn=on

Ausschalten

http://192.168.178.35/relay/0?turn=off

Einschalten für eine Zeit

http://192.168.178.35/relay/0?turn=on&timer=3

Bei timer=3 schaltet der Shelly nach 3 Sekunden von selbst wieder aus. Die Zeit wird in Sekunden angegeben.

URL testen: Die URL auf einem Smartphone oder PC im gleichen WLAN in die Adresszeile des Browsers eingeben. Der Türöffner muss für die angegebene Zeit summen. Der Browser zeigt dabei eine kurze Antwort des Shelly an, z. B. {"ison":true, …}.

Hinweis: Die URL beginnt mit http://, nicht mit https://. Der Shelly unterstützt im Heimnetz nur unverschlüsselte Aufrufe.

4. API-Aktion in der DoorLine Snap einrichten

Die Weboberfläche der DoorLine Snap im Browser über die vom Router vergebene IP-Adresse oder mit doorline-snap.local öffnen und mit der PIN anmelden. Die IP-Adresse ist z. B. in der FRITZ!Box unter WLAN > Funknetz zu finden.

Schritt 1 – API-Aktionen öffnen

In der Weboberfläche zum Bereich API-Aktionen scrollen. Dort stehen vier Auslöser (Auslöser 1 bis Auslöser 4) mit jeweils einem eigenen Feld für die URL zur Verfügung.

Schritt 2 – Auslöser festlegen

Bei Auslöser 1 den Eintrag Türöffner für beide Klingeltasten auswählen und in das zugehörige URL-Feld die URL aus Abschnitt 3 eintragen, z. B.:

http://192.168.178.35/relay/0?turn=on&timer=3
image-20261014-115354.png

Die DoorLine Snap ruft die URL auf, sobald am gerufenen FRITZ!Fon der Softkey Tür öffnen gedrückt bzw. am Telefon der Türöffner-Code eingegeben wird. Das gilt für Türrufe beider Klingeltasten.

Für den Auslöser stehen folgende Einträge zur Auswahl:

Auslöser

Die URL wird aufgerufen …

Türöffner für Klingeltaste 1 (intern)

… wenn nach einem Türruf über Klingeltaste 1 die Tür geöffnet wird

Türöffner für Klingeltaste 2 (extern)

… wenn nach einem Türruf über Klingeltaste 2 die Tür geöffnet wird

Türöffner für beide Klingeltasten

… wenn nach einem Türruf über eine der beiden Klingeltasten die Tür geöffnet wird

Bei Betätigung der Klingeltaste 1 (intern)

… beim Drücken von Klingeltaste 1

Bei Betätigung der Klingeltaste 2 (extern)

… beim Drücken von Klingeltaste 2

Bei Betätigung einer Klingeltaste

… beim Drücken einer beliebigen Klingeltaste

Schalteingang geschlossen

… beim Schließen des Schalteingangs (Schalteingang muss aktiviert sein)

Schalteingang geöffnet

… beim Öffnen des Schalteingangs (Schalteingang muss aktiviert sein)

Aus / keine Funktion

Der Auslöser ist deaktiviert.

Hinweis: Sollen bei zwei Klingeltasten (z. B. Haustür und Hoftor) unterschiedliche Türöffner geschaltet werden, statt Türöffner für beide Klingeltasten zwei Auslöser verwenden: Türöffner für Klingeltaste 1 (intern) mit der URL des ersten Shelly und Türöffner für Klingeltaste 2 (extern) mit der URL des zweiten Shelly.

Hinweis: Die vier Auslöser können in beliebiger Reihenfolge belegt werden. Nicht benötigte Auslöser auf Aus / keine Funktion stellen.

Schritt 3 – Speichern

Auf Speichern klicken. Ohne Speichern werden die Änderungen beim Verlassen der Seite verworfen.

Hinweis: Bei der DoorLine Cam heißen die Auslöser Türöffner bzw. Bei Betätigung der Klingeltaste. Die Einrichtung erfolgt sonst genauso.

5. Testen

An der DoorLine Snap klingeln und den Anruf am FRITZ!Fon annehmen. Anschließend den Softkey Tür öffnen drücken. Ohne FRITZ!Fon nach der Rufannahme #9 eingeben. Der Türöffner muss für die eingestellte Zeit summen.

Hinweis: Die Türöffnerfunktion steht nur während eines angenommenen Türrufs zur Verfügung.

Gong oder Licht über einen weiteren Shelly schalten

Für jeden weiteren Verbraucher wird ein eigener Shelly mit eigener IP-Adresse verwendet. Insgesamt stehen in der DoorLine Snap vier Auslöser zur Verfügung.

Türgong beim Klingeln

Einen freien Auslöser, z. B. Auslöser 2, auf Bei Betätigung der Klingeltaste 1 (intern) stellen und in das zugehörige URL-Feld die URL des Shelly für den Gong eintragen, z. B. für einen kurzen Impuls von 1 Sekunde:

http://192.168.178.36/relay/0?turn=on&timer=1

Soll der Gong bei beiden Klingeltasten ertönen, Bei Betätigung einer Klingeltaste wählen.

Licht beim Klingeln

Einen freien Auslöser, z. B. Auslöser 3, auf Bei Betätigung einer Klingeltaste stellen und in das zugehörige URL-Feld die URL des Shelly für das Licht eintragen, z. B. für 2 Minuten:

http://192.168.178.37/relay/0?turn=on&timer=120

Anschließend jeweils auf Speichern klicken.

Hinweis: Soll das Licht nur bei Dunkelheit eingeschaltet werden, ist dafür ein Smart-Home-System erforderlich, z. B. Home Assistant → siehe hierzu: (v2) Nachts beim Klingeln Licht im Flur einschalten.

Shelly der neueren Generation (RPC-Befehle)

Die URLs mit /relay/0 werden von den Shelly-Geräten der Generation 1 und von den meisten neueren Geräten unterstützt. Funktioniert die URL bei einem neueren Shelly nicht, kann alternativ der folgende Befehl verwendet werden:

Funktion

URL (Beispiel)

Einschalten für eine Zeit

http://192.168.178.35/rpc/Switch.Set?id=0&on=true&toggle_after=3

toggle_after=3 entspricht dabei timer=3.

Fehlerbehebung

Türöffner reagiert nicht beim Drücken von „Tür öffnen“ Die URL des Shelly im Browser eines Geräts im gleichen WLAN testen (siehe Schritt 3). Funktioniert der Aufruf im Browser, im URL-Feld der DoorLine Snap auf Tippfehler prüfen, z. B. https:// statt http:// oder Leerzeichen am Anfang oder Ende. Außerdem prüfen, ob der richtige Auslöser gewählt und gespeichert ist.

Türöffner reagiert nur bei einer der beiden Klingeltasten Als Auslöser ist Türöffner für Klingeltaste 1 (intern) bzw. Türöffner für Klingeltaste 2 (extern) gewählt. Die URL wird dann nur bei Türrufen über diese Klingeltaste aufgerufen. Stattdessen Türöffner für beide Klingeltasten wählen.

Türöffner reagiert nur bei Rufannahme am FRITZ!Fon, nicht am Smartphone Am Smartphone oder an anderen Telefonen gibt es keinen Softkey Tür öffnen. Nach der Rufannahme #9 eingeben.

Aufruf im Browser funktioniert nicht Prüfen, ob die IP-Adresse des Shelly noch stimmt. Diese ist im Router oder in der App Shelly Smart Control zu finden. Hat sich die Adresse geändert, eine feste IP-Adresse vergeben (siehe Schritt 2) und die URL in der DoorLine Snap anpassen. Bei neueren Shelly-Geräten den RPC-Befehl verwenden (siehe oben).

Shelly lehnt den Aufruf ab (Fehler 401) In der Weboberfläche des Shelly ist ein Passwort aktiviert. Das Passwort unter Authentication deaktivieren.

Shelly startet nicht Bei 12 V DC muss der Pluspol an der Klemme 12V und der Minuspol an der Klemme L angeschlossen sein. Die Klemme N bleibt frei (siehe Abschnitt 1).

Shelly schaltet hörbar, aber der Türöffner reagiert nicht Die Verdrahtung nach dem Anschlussplan in Schritt 1 prüfen. Der Türöffner muss über den Kontakt I–O geschaltet werden, und I muss mit der Versorgung des Türöffners verbunden sein.

Shelly startet beim Öffnen neu Shelly und Türöffner werden über ein gemeinsames Netzteil versorgt und die Spannung bricht beim Einschalten des Türöffners ein. Den Türöffner über ein separates Netzteil bzw. einen Klingeltrafo versorgen (siehe Schritt 1).

Türöffner funktioniert nur zeitweise Die DoorLine Snap oder der Shelly verliert die WLAN-Verbindung. Ohne Netzwerkverbindung entfallen alle HTTP-Requests. Die WLAN-Signalstärke am Montageort beider Geräte prüfen, z. B. in der Weboberfläche des Shelly bzw. unter Info in der Weboberfläche der DoorLine Snap. Gegebenenfalls einen WLAN-Repeater einsetzen.

Türöffner summt zu kurz Manche Türöffner benötigen mindestens 2–3 Sekunden. Den Wert bei timer in der URL erhöhen. Ist im Shelly Auto off aktiviert, auch diesen Wert anpassen, da der kürzere der beiden Werte gilt.

Türöffner bleibt dauerhaft geschaltet In der URL fehlt die Zeitangabe timer und im Shelly ist Auto off nicht aktiviert. Die URL um &timer=3 ergänzen und Auto off aktivieren (siehe Schritt 2).

Sicherheitshinweise

  • Den Shelly nur im lokalen Heimnetz betreiben und nicht aus dem Internet erreichbar machen, z. B. über eine Portfreigabe im Router.

  • Die URL wird unverschlüsselt im Heimnetz übertragen. Jedes Gerät im WLAN, das die URL kennt, kann den Türöffner schalten. Gäste deshalb in ein separates Gast-WLAN einbuchen.