SFC
SunFlowControl

MQTT-Zugang: eigene Programme und Geräte

Persönlicher Zugang für Home Assistant, ioBroker & Co., Geräte-Zugang für Hubs, die per Zendure-App verbunden werden - Daten, Topics und Sicherheit.

Welche MQTT-Zugänge es gibt

Unser MQTT-Server ist der Knotenpunkt, über den Deine Hubs mit SunFlowControl sprechen. Zusätzlich kannst Du ihn selbst nutzen: mit eigenen Programmen Werte lesen und Hubs steuern, oder neuere Hubs ohne Bluetooth-Umstellung anbinden. Dafür gibt es unter Konfiguration → MQTT-Zugang getrennte Zugänge:

ZugangWofürWas er darf
Persönlicher Zugang
user_…
Home Assistant, ioBroker, Node-RED oder ein eigenes SkriptWerte der ausgewählten Hubs lesen und ihnen Befehle schicken, dazu alles unter users/<Dein Benutzername>/
Geräte-Zugang
zdev_…
Hubs, deren MQTT-Server Du in der Zendure-App einträgst (neuere Modelle)Als Hub Werte melden und Befehle empfangen - für alle Deine aktiven Hubs
Shelly-Zugang
shelly_…
Shelly-Messgeräte, angelegt von der SFC-AppNur Messwerte melden

Hubs, die Du mit der SFC-App per Bluetooth umgestellt hast, brauchen keinen dieser Zugänge: Sie melden sich mit einer eigenen, festen Kennung an, die bei der Aktivierung eingerichtet wird.

Seite MQTT-Zugang mit Server und Ports, dem persönlichen Zugang mit Benutzername, verdecktem Passwort und den lesbaren Hubs samt Topics sowie dem Geräte-Zugang für die Zendure-App
Konfiguration → MQTT-Zugang: Serverdaten, persönlicher Zugang mit wählbaren Hubs und Geräte-Zugang für Hubs aus der Zendure-App.
Server: mqtt.sunflowcontrol.de, Port 1883 oder verschlüsselt 8883 (TLS). Die genauen Daten für Dein Konto stehen immer oben auf der Seite MQTT-Zugang.

Persönlicher Zugang: Home Assistant, ioBroker & Co.

Mit dem persönlichen Zugang holst Du die Werte Deiner Hubs in Dein eigenes System, etwa um sie in Home Assistant anzuzeigen oder mit anderen Geräten zu verknüpfen.

  1. Öffne Konfiguration → MQTT-Zugang und klicke auf Persönlichen Zugang anlegen. Benutzername und Passwort erzeugen wir; über das Auge siehst Du das Passwort, daneben kopierst Du es.
  2. Hake unter Lesbare Hubs die Hubs an, die Dein Programm sehen soll, und klicke auf Auswahl speichern. Nur aktive Hubs sind erreichbar.
  3. Trage in Deinem Programm Server, Port, Benutzername und Passwort ein. In Home Assistant ist das die MQTT-Integration, in ioBroker der MQTT-Client-Adapter.
Topics

Die Tabelle auf der Seite zeigt für jeden Hub die genauen Themen. Sie folgen dem Muster der Zendure-Hubs:

Werte lesen/<Produkt-ID>/<Device ID>/# - der Hub meldet seine Werte als JSON, laufend unter …/properties/report.
Befehle sendeniot/<Produkt-ID>/<Device ID>/properties/write mit einem JSON wie {"properties": {"outputLimit": 200}}. Mehr braucht es nicht - so steuern auch unsere Controller die Hubs. Werte gezielt anfordern geht mit {"properties": ["getAll"]} an …/properties/read.
Eigene Bereicheusers/<Dein Benutzername>/# - hier stellen wir Werte für Dich bereit.
Steuert ein SunFlowControl-Controller den Hub, überschreibt er eigene Befehle beim nächsten Regelschritt. Schicke Befehle nur an Hubs, die gerade kein Controller steuert, oder deaktiviere den Controller vorher.

Geräte-Zugang: Hubs aus der Zendure-App

Neuere Zendure-Modelle lassen sich in der Zendure-App auf einen eigenen MQTT-Server umstellen. Dabei gibst Du auch einen Benutzernamen und ein Passwort ein - das ist der Geräte-Zugang.

  • Er gilt automatisch für alle Deine aktiven Hubs. Aktivierst Du später einen weiteren Hub, ist er sofort mit abgedeckt.
  • Er darf genau das, was ein Hub braucht: seine Werte melden und die Befehle von SunFlowControl empfangen. Lesen kann er sonst nichts.
  • Du kannst denselben Zugang in mehreren Hubs eintragen.

Die Schritt-für-Schritt-Anleitung pro Hub findest Du unter Neuere Modelle: Verbindung über die Zendure-App.

Passwort, Deaktivieren und Sicherheit

Neues Passwort

Neues Passwort erzeugt sofort ein neues Passwort; das alte gilt dann nicht mehr. Trage das neue überall ein, wo der Zugang verwendet wird - beim Geräte-Zugang also in jedem Hub in der Zendure-App.

Deaktivieren

Deaktivieren sperrt den Zugang auf dem Server, die Einstellungen bleiben erhalten. Mit Aktivieren gilt er wieder mit demselben Passwort.

Wann wirkt eine Änderung?

In der Regel sofort. Meldet die Seite, dass der Server gerade nicht aktualisiert werden konnte, ist die Änderung trotzdem gespeichert und wird spätestens beim nächtlichen Abgleich übernommen.

Jeder Zugang erreicht nur Deine eigenen Hubs und Themen. Nutze wo möglich den verschlüsselten Port 8883 und gib Zugangsdaten nicht weiter - wer sie hat, kann Deinen Hubs Befehle schicken.
Noch Fragen? Kurze Antworten findest Du in den häufigen Fragen zu diesem Thema.