Marantec Maveo Connect / Zapf Connect inkl. Alexa und Google Assistant Steuerung

Owned by Thomas R.
Last updated: 22.07 2021Version comment
5 min read

Der Torantriebhersteller Marantec hat vor einigen Jahren das System maveo Connect entwickelt, welches vom Fertiggaragenhersteller Zapf unter dem Produktnamen Zapf connect vertrieben wird.

In diesem Artikel werde ich nur noch von Connect sprechen und meine damit sowohl Zapf, als auch maveo, da diese grundsätzlich identisch sind. Zapf nutzt nur die Whitelabeling Lösung von Marantec.

Im Dezember 2020 wurde der Connect App dann die lange ersehnte "Drittanbieter Anwendungszugriff" Funktionalität spendiert, die ein Öffnen der UDP- und/oder TCP-Ports ermöglicht und sowohl ein Lesen von Werten, als auch ein Schreiben ermöglicht, um den Garagenantrieb zu steuern.

In diesem Artikel möchte ich meine Erfahrungen damit mit Euch teilen und aufzeigen, wie ich sowohl die Steuerung via Loxone, als auch mit Hilfe von Node Red die Bedienung durch Alexa und Google Assistant realisiert habe.

Schritt-für-Schritt-Anleitung zur Verbindung der Connect Box mit Loxone Miniserver

  1. Sicherstellen, dass die Connect Box eine feste IP Adresse in eurem Netzwerk erhält. Hierzu bitte die DHCP-Reservierung des Routers für die Mac-Adresse der Box einrichten
  2. Connect App
    1. Start der Connect App
    2. Wechsel zu Einstellungen (Zahnrad unten rechts)
    3. Tippen auf "Box"
    4. Ganz nach unten Scrollen und Auswahl Auswahl "Drittanbieter Anwendungszugriff"
    5. Aktivieren von UDP Steuerung auf Port 2784 und/oder TCP auf Port 2785 (entsprechend sind später in Loxone Config die Adressen zu setzen)
    6. Prüfen des Garagenantriebsnamens auf der Home-Seite (wird gleich wichtig für die Befehlserstellung)
  3. Loxone Config

    1. Werte lesen über virtuellen Eingang VI

      1. Ich habe hier einen virtuellen UDP Eingang verwendet und für "XY Connect" benannt, die IP Adresse der Box und den Port 2784 gesetzt

        Da Loxone im Baustein "Tor" nur mit den digitalen Statuseingängen Tor ganz offen und Tor ganz geschlossen etwas anfangen kann, nutze ich nur diese beiden Eingangswerte von der Connect Box (Es gibt Stand Januar 2021 folgende Zustände seitens der Connect Box: open, closed, opening, closing, lightOn, lightOff)

      2. Erstellung der virtuellen Eingangsbefehle nach folgendem Schema
        Befehlserkennung:

        StatusBefehlserkennung
        Tor geöffnetS;<Name des Garagentors gemäß Connect App>;open\n
        Tor geschlossenS;<Name des Garagentors gemäß Connect App>;closed\n
        Tor öffnetS;<Name des Garagentors gemäß Connect App>;opening\n
        Tor schließtS;<Name des Garagentors gemäß Connect App>;closing\n
        Licht am Torantrieb anS;<Name des Garagentors gemäß Connect App>;lightOn\n
        Licht am Torantrieb ausS;<Name des Garagentors gemäß Connect App>;lightOff\n

        S steht für Status

      3. Befehle mit Tor-Baustein auf Do (geöffnet) und Dc (geschlossen) verbinden
    2. Werte schreiben / Garagentorantrieb steuern
      1. Tor-Baustein konfigurieren - In meinem Fall habe ich etwa 20 Sekunden für eine Auf-Fahrt und 25 Sekunden für eine Zu-Fahrt. Die Anschlussart des Antriebs ist "direkt". 
      2. Erstellung virtueller Ausgang "XY Connect" mit Adresse für Beispiel UDP "/dev/udp/IP-Connect-Box/2784" / Alternativ TCP mit tcp://IP-Connect-Box:2785

      3. Erstellung virtueller Ausgangsbefehle

        BefehlBefehl bei EIN
        Tor öffnenC;<Name des Garagentors gemäß Connect App>;open
        Tor schließenC;<Name des Garagentors gemäß Connect App>;close

        C steht für Command

      4. Befehle mit Tor-Baustein auf Qo (öffnen) und Qc (shließen) verbinden
      5. Um einen Taster zu verwenden, der sonst nur für ein sowieso bewegungsgesteuertes Außenlicht (nicht) verwendet wird, habe ich dann noch zur Funktion Mehrfachklick gegriffen und den einfachen Klick auf den Eingang Tr gesetzt. So kann das Tor darüber geöffnet, gestoppt und weiter geöffnet werden oder in die andere Richtung. Ein Richtungswechsel nach Stoppen scheint durch den Tor-Baustein nicht vorgesehen zu sein.

Lösung für Alexa und Google Assistant Anbindung via Node-RED

Da mein vornehmliches Ziel war, das Tor dann auch per Sprache steuern zu können, habe ich auf mein Node-RED Setup mit Alexa und Loxone zurückgegriffen, das ich schon für die Lampen und Rolläden verwende und später noch eine Google Assistant Anbindung dazugebaut.

Folgende Node-RED Paletten sind hier in Verwendung:
node-red-contrib-alexa-home https://flows.nodered.org/node/node-red-contrib-alexa-home (lokal, sehr stabil)
node-red-contrib-googlehome https://flows.nodered.org/node/node-red-contrib-googlehome (leider keine rein lokale Lösung)
node-red-contrib-loxone https://flows.nodered.org/node/node-red-contrib-loxone

Die Links zu entsprechenden Guides versuche ich noch, wieder zu finden und verlinke diese.


Die Funktionen waren hier für mich als Nicht-Anwendungsentwickler eigentlich die größte Herausforderung, aber was lange wärt...

Was man im unteren Screenshot sehen kann, ist, dass ich bei Google Assistant direkt mit dem Torantrieb sprechen und öffnen und schließen befehlen kann. Alexa ist da leider etwas eingeschränkter, weil es sich hier um ein Hue-Imitat handelt. Das heißt, dass die Geräte in den linken Bausteinen quasi als Lampen in Alexa angelegt sind.

In Google Home habe ich hier tatsächlich eine Tür.

Alexa

  1. Installation Node-RED https://loxwiki.atlassian.net/wiki/x/wwFuWw
  2. Installation der Paletten (selber Artikel wie bei 1.)
    1. node-red-contrib-alexa-home unter Beachtung der Informationen auf https://flows.nodered.org/node/node-red-contrib-alexa-home
    2. node-red-contrib-loxone unter Beachtung der Informationen auf https://flows.nodered.org/node/node-red-contrib-loxone
  3. Anlage Alexa Controller in Node-RED angelegt werden, sowie die Nodes für die "Lampen"/ Befehle (bitte hier auch die Erläuterungen zur Einrichtung auf der Node Red Seite beachten) angelegt werden.

  4. Ich habe Subflows für die Funktionen erstellt, um diese immer wieder aufrufen und verwenden zu können, ist aber für den Anfang nicht nötig. Wichtig ist die Funktion, welche für Beleuchtung ausgelegt ist, aber funktioniert. (Zwinkern)

    if(msg.payload.command == "off" || !msg.payload.on) {
    msg.payload = "off";
} else if(msg.payload.command == "dim") {
        msg.payload = msg.payload.bri_normalized
} else if(msg.payload.command == "color") {
        msg.payload = "";
} else {
    msg.payload = "on";
}
return msg;
  5. Verbinden der Nodes mit der Funktion
  6. Suche nach neuen Geräten auf https://alexa.amazon.de/spa/index.html?#appliances oder in der Alexa App
  7. Test (Lächeln)

Google Home / Assistant

  1. Installation Node-RED https://loxwiki.atlassian.net/wiki/x/wwFuWw
  2. Installation der Paletten (selber Artikel wie bei 1.)
    1. node-red-contrib-googlehome unter Beachtung der Informationen auf https://flows.nodered.org/node/node-red-contrib-googlehome
      1. Registrierung
      2. Anlage des Geräts vom Typ "Door" mit entsprechendem Bezeichner Garagentor und Raum Garage
      3. Anbindung an Google Konto gemäß Anleitung
    2. node-red-contrib-loxone unter Beachtung der Informationen auf https://flows.nodered.org/node/node-red-contrib-loxone
  3. Anlage Google Home Node und Verbindung mit registriertem Konto aus Punkt 2.a.

  4. Funktion für Übersetzung GHome zu Loxone

    if(msg.payload.params.openPercent >0) {
    msg.payload = "open";
} else {
    msg.payload = "close";
}
return msg;
  5. Test (Lächeln)

Verwandte Artikel