Zum Hauptinhalt springen

Hubitat-Connector

Der Hubitat-Connector verbindet einen Hubitat-Hub mit dem MQTT-Broker der Plattform, und zwar in beide Richtungen: Gerätezustände fließen vom Hub nach Yggio, und Befehle fließen von Yggio zurück zum Hub.

Was Ihnen das bringt​

Alles, was der Hub spricht, spricht Yggio. Das ist der Sinn dieses Connectors. Hubitat ist ein lokaler Hub mit eigenen Funkschnittstellen und eigener Protokollunterstützung, einen anzubinden holt also diesen gesamten Bestand als gewöhnliche Geräte nach Yggio:

  • Z-Wave
  • Zigbee
  • Matter und Thread
  • Lutron-, LAN- und Cloud-Integrationen sowie alles Weitere, was Hubitat über eigene und Community-Treiber unterstützt

Statt dass Yggio je Protokoll ein Funkmodul oder eine Integration bräuchte, übernimmt der Hub das Protokoll und Yggio die Daten. Ein Z-Wave-Türkontakt und eine Zigbee-Steckdose kommen als Geräte an wie jeder LoRaWAN-Sensor: dieselben kanonischen Felder, dieselben Ansichten, dieselben Regeln, dieselben Berichte.

Die Steuerung funktioniert genauso herum. Weil der Connector Downlinks trägt, kann eine Regel in Yggio ein Z-Wave-Relais schalten oder einen Dimmwert setzen, und die daraus folgende Zustandsänderung kommt unmittelbar zurück.

Unterstützte Vorgänge:

  • Geräte vom Hub erscheinen automatisch in Yggio, mit fortlaufend abgeglichenem Zustand
  • Von Yggio gesendete Befehle werden auf dem Hub ausgeführt
  • Die Heartbeats des Hubs werden verfolgt, sodass ein Hub, der nicht mehr meldet, sichtbar wird

Bevor Sie beginnen​

Der Connector ist die Yggio-Hälfte einer größeren Integration. Die Hubitat-Hälfte, also die Installation von Sensatives App und Treiber auf dem Hub und die Auswahl der zu teilenden Geräte, wird in Hubitat-Integration behandelt. Erledigen Sie das parallel dazu, denn jede Seite braucht Werte von der anderen.

Zwei Dinge müssen in Yggio existieren, bevor der Connector angelegt werden kann:

VoraussetzungWas es ist
Basic Credentials SetBenutzername und Passwort, mit denen der Hub den MQTT-Broker erreicht. Seine _id bestimmt das Topic des Connectors
Reserviertes MQTT-TopicReserviert yggio/hubitat/v1/<basicCredentialsSetId>, sodass nur Ihr Hub dort publizieren kann

Beides wird über das API angelegt. Die genauen Aufrufe stehen in Hubitat-Integration.

Außerdem brauchen Sie die Hub-UID vom Hubitat-Hub selbst, zu finden in dessen Einstellungen.

Den Connector anlegen​

  1. Gehen Sie zu Connectors → Neuer Connector → Hubitat.
  2. Wählen Sie Retention Policy und Flow und fahren Sie fort.
  3. Füllen Sie die Angaben zum Connector aus:
FeldBeschreibung
NameEin Name für den Connector
Basic Credentials Set IDDie _id des oben angelegten Basic Credentials Sets, zum Beispiel 66471de08fdcf621179a94ec
Hubitat Hub UIDDie eindeutige Kennung des Hubs, zum Beispiel 84af009e-4384-4820-ba7e-4837f21336e4, zu finden in den Hubitat-Einstellungen
  1. Bestätigen Sie die Angaben und legen Sie den Connector an.

Das MQTT-Topic wird für Sie als yggio/hubitat/v1/<basicCredentialsSetId>/# abgeleitet, und genau deshalb muss das reservierte Topic zum selben Credentials Set passen.

Überprüfen​

  1. Bestätigen Sie am Hub, dass der Treiber Sensative Yggio MQTT als verbunden gemeldet wird.
  2. Teilen Sie ein Gerät aus der Hubitat-App und warten Sie, bis es meldet.
  3. Prüfen Sie, dass das Gerät in Yggio erscheint und sein Zustand dem Hub entspricht.
  4. Ändern Sie das Gerät am Hub, ein Schalter ist am einfachsten, und bestätigen Sie, dass der neue Zustand Yggio erreicht.
  5. Lösen Sie die Änderung von Yggio aus und bestätigen Sie, dass der Hub sie ausführt.

Fehlerbehebung​

In Yggio kommt nichts an. Fast immer die Zugangsdaten oder das Topic. Bestätigen Sie, dass der Hub Benutzername und Passwort aus dem Basic Credentials Set verwendet und dass das reservierte Topic mit derselben basicCredentialsSetId angelegt wurde, die der Connector nutzt. Der Broker lehnt eine Verbindung ohne gültige Zugangsdaten ab, unabhängig davon, wie das Topic heißt.

Geräte erscheinen, aktualisieren sich aber nicht. Prüfen Sie in der Hubitat-App, ob das Gerät weiterhin zum Teilen ausgewählt ist. Später am Hub hinzugefügte Geräte werden nicht automatisch geteilt; sie müssen erneut ausgewählt und gespeichert werden.

Befehle aus Yggio bewirken nichts. Bestätigen Sie, dass der Treiber des Geräts den gesendeten Befehl unterstützt und dass der Hub verbunden und nicht bloß konfiguriert ist.

Die vollständige Durchsprache beider Seiten finden Sie in Hubitat-Integration.