Wie man ein einfaches Shelly 1 in eine intelligente Garagentor-Steuerung verwandelt, die sich in Home Assistant wie eine native Komponente anfühlt.

Wer kennt das Problem nicht: Der Garagentorantrieb lässt sich zwar per Transponder steuern, aber die Einbindung in Home Assistant fehlt. Anstatt für viel Geld einen neuen Antrieb zu kaufen, lässt sich das Problem mit einem Shelly 1 und minimalem finanziellen Aufwand lösen.

Das folgende Skript verwandelt das Shelly 1 Smart Relay in eine voll ausgestattete Garagentor-Steuerung, die über MQTT nahtlos in Home Assistant integriert wird. Es nutzt einen einfachen Endlagenschalter, um die geschlossene Position des Tores zu erkennen, und steuert den Antrieb über den potenzialfreien Relaisausgang des Shelly. Dieser wird kurzzeitig mit dem Triggereingang des Antriebs verbunden – so als würde man den Wandtaster drücken. Keine zusätzliche Hardware erforderlich.

Die Hardware-Brücke

Der Aufbau ist elegant und simpel. Das Shelly 1 fungiert dabei als “Hände” und “Augen” der Operation:

  1. Die Hände (Relais): Die meisten Antriebe haben einen Anschluss für einen einfachen Wandtaster. Indem wir das potenzialfreie Relais des Shelly mit diesem Eingang verbinden, können wir per Skript einen Tastendruck mit einem kurzen 500ms-Impuls simulieren.
  2. Die Augen (Endlagenschalter): Ein einfacher Endlagenschalter am Boden des Tores meldet dem Shelly, wenn der Stromkreis geschlossen ist – das bedeutet, das Tor ist sicher zu.
  3. Das Gehirn (Skript): Hier passiert die eigentliche Magie. Über die Shelly Gen2+ Scripting API habe ich eine Steuerung geschrieben, die eine echte State Machine verwaltet.

Endlagenschalter installiert an der Unterseite des Garagentors

Eine zuverlässige State Machine

Ein einfacher “Toggle”-Befehl reicht für eine hochwertige Integration nicht aus. Wenn man einen “Öffnen”-Befehl sendet, während das Tor bereits auffährt, würden die meisten Antriebe stoppen oder sofort wieder schließen.

Mein Skript fängt diese Nuancen ab, indem es Zustände wie opening (öffnet) und closing (schließt) präzise verfolgt. Es enthält sogar einen Sicherheits-Timeout: Wenn der Befehl zum Schließen gegeben wurde, aber der Endlagenschalter nicht innerhalb von 30 Sekunden auslöst, geht das Skript von einem Problem aus und setzt den Status in Home Assistant auf open zurück, anstatt einen falschen, veralteten Zustand anzuzeigen.

Native Integration via MQTT

Das Beste an diesem Setup ist, dass es sich absolut nativ anfühlt. Dank MQTT Auto-Discovery stellt sich das Shelly, sobald es sich mit dem Broker verbindet, in Home Assistant automatisch als cover-Entität vor. Keine manuelle YAML-Konfiguration, kein Raten – einfach eine funktionierende Garagentor-Karte, die sofort auf dem Dashboard bereitsteht.

Hol dir den Code

Das vollständige Skript, inklusive aller Konfigurationsoptionen und der State Machine Logik, ist auf GitHub verfügbar. Egal ob du ein Shelly 1 Gen2, Gen3 oder das neueste Gen4 verwendest: Dieses Skript liefert die robuste Brücke, die dein “dummes” Garagentor braucht, um ein erstklassiges Mitglied in deinem Smart Home zu werden.

Project Repository: https://github.com/mtasior/ShellyGarageDoor