Zum Hauptinhalt springen

Tasmota Community-Integration, kostenlos und Open Source

Tasmota-Integration für Gladys Assistant

Steuern Sie Ihre Tasmota-Geräte lokal per MQTT oder HTTP: Relais, Lampen, Energie, Sensoren.

Steuern Sie Ihre Tasmota-Geräte aus Gladys, zu 100 % lokal: Steckdosen, Relais, Lampen und LED-Streifen, Dimmer, Rollläden, Ventilatoren, Energiezähler und Sensoren. Keine Cloud.

Was Sie bekommen​

  • Automatische Erkennung per MQTT (LWT, Status 0 und die native Tasmota-Erkennung) und per HTTP (eine Adressliste oder der Scan eines IP-Bereichs).
  • Jedes Gerät wird über seine MAC-Adresse erkannt: Umbenennen, ein neues Topic, eine neue IP oder der Wechsel von HTTP zu MQTT behalten dasselbe Gladys-Gerät und seinen Verlauf.
  • Relais (POWER1…POWER8), Lampen (Ein/Aus, Helligkeit, RGB-Farbe, Farbtemperatur, Effekte und ihre Geschwindigkeit), Ventilatoren (FanSpeed), Rollläden (öffnen / schließen / stoppen, Position).
  • Energiemessung: Leistung, Schein- und Blindleistung, Spannung, Strom, Energie heute, gestern und gesamt (der Gesamtwert ist ein kumulierter Zählerstand, nutzbar für die Energieüberwachung von Gladys), Mehrkanalzähler inklusive.
  • Sensoren: Temperatur, Luftfeuchtigkeit, Luftdruck, Helligkeit, CO2, VOC, PM2.5 / PM10, Entfernung, UV-Index, Bodenfeuchte, Analogeingänge, Impulszähler, Schaltereingänge, Chiptemperatur, WLAN-Signal und Laufzeit.
  • Szenen-Auslöser: Taste gedrückt (einfach, doppelt, dreifach… halten), Schaltereingang geändert, RF-Code empfangen (Sonoff RF Bridge), IR-Code empfangen, Gerät online / offline.
  • Szenen-Aktionen: beliebigen Tasmota-Befehl senden (Backlog, RfSend, IRSend, Rule…), ein Relais zeitweise einschalten, eine Lampe blinken lassen, ein Gerät neu starten.
  • Dashboard-Widgets: Geräteübersicht, Gerätekarte, Energiekarte.
  • Ein „Lokal“-Badge an jedem Gerät, orange wenn der Broker ausgefallen ist und Befehle über HTTP laufen, rot wenn das Gerät nicht erreichbar ist.

Wählen, wie die Geräte mit Gladys sprechen​

Die Konfigurationsseite beginnt mit Schritt 1 — Verbindungsmodus, gefolgt von drei Blöcken. Gladys zeigt alle Blöcke gleichzeitig: Füllen Sie nur den Block der gewählten Option aus, die anderen werden ignoriert und können leer bleiben. Der Status oben auf der Seite zeigt immer die aktive Option und was noch fehlt.

VerbindungsmodusAusfüllenSie brauchen
Option 1 — Mein vorhandener MQTT-BrokerBlock 1Adresse und Zugangsdaten
Option 2 — Eigener Broker, von der IntegrationBlock 2nichts (Passwort optional)
Option 3 — Kein MQTT, nur HTTPBlock 3die IP-Adressen der Geräte

Option 1 — Mein vorhandener MQTT-Broker​

Zum Beispiel der Broker der Gladys-MQTT-Integration, der bereits auf dem Gladys-Host läuft (Port 1883, mit Benutzer und Passwort von der Seite dieser Integration).

  1. Verbindungsmodus: Option 1 — Mein vorhandener MQTT-Broker.
  2. Block 1 — Broker-URL: mqtt://<IP des Brokers>:1883 — verwenden Sie die LAN-IP, nicht localhost (die Integration läuft in einem eigenen Container).
  3. Block 1 — Broker-Benutzer und Broker-Passwort, dann speichern.
  4. Auf jedem Tasmota-Gerät: Configuration → MQTT, denselben Host, Port, Benutzer und dasselbe Passwort eintragen.

Option 2 — Eigener Broker, von der Integration bereitgestellt​

  1. Verbindungsmodus: Option 2 — Eigener Broker, von der Integration bereitgestellt.
  2. Block 2 — Passwort der Geräte: optional, leer lassen, um eines zu erzeugen. Speichern: Die Integration startet einen eigenen Mosquitto-Container; Block 2 zeigt Adresse und Port für die Geräte (Benutzer tasmota).
  3. Führen Sie die Aktion Option 2 — Befehl für die Geräte abrufen aus (IP-Adresse von Gladys eingeben): Sie liefert eine Zeile zum Einfügen, z. B. Backlog MqttHost 192.168.1.10; MqttPort 41883; MqttUser tasmota; MqttPassword ….
  4. Fügen Sie sie in die Console jedes Tasmota-Geräts ein. Das Gerät startet neu und erscheint in Gladys.

MQTT-Topics (Optionen 1 und 2)​

Behalten Sie %prefix%/%topic%/, den Tasmota-Standard, außer Sie haben das Full Topic Ihrer Geräte auf %topic%/%prefix%/ geändert.

Option 3 — Kein MQTT, nur HTTP​

  1. Verbindungsmodus: Option 3 — Kein MQTT, nur HTTP.
  2. Block 3 — HTTP-Adressen: 192.168.1.20, 192.168.1.30-45 (oder die Aktion IP-Bereich scannen nutzen).
  3. Web-Benutzer (admin) und Web-Passwort: nur wenn auf den Geräten ein Web-Passwort gesetzt ist. Die Geräte werden alle HTTP-Aktualisierungsintervall Sekunden gelesen (standardmäßig 30).

Block 3 funktioniert auch mit den Optionen 1 und 2, für die wenigen Geräte ohne MQTT. Ein per HTTP gefundenes Gerät, das sich später mit dem Broker verbindet, wechselt von selbst zu MQTT; die Aktion Gerät auf MQTT umstellen sendet ihm die Broker-Einstellungen für Sie.

Geräte hinzufügen​

Öffnen Sie den Reiter Erkennung der Integration: Die gefundenen Geräte erscheinen dort mit ihren Funktionen. Klicken Sie auf Hinzufügen, wählen Sie den Raum, fertig. Bekommt ein Gerät eine neue Funktion (ein angeschlossener Sensor, eine neue Firmware), erscheint eine Schaltfläche Aktualisieren.

Von der integrierten Tasmota-Integration migrieren​

Sie nutzen die in Gladys eingebaute Tasmota-Integration? Gladys kann jedes Gerät mit einem Klick auf diese Integration umstellen und dabei den Verlauf seiner Zustände, die Szenen und Dashboards, die es verwenden, seinen Raum und die Thermostat-Einstellungen, die darauf verweisen, behalten. Das alte Gerät wird anschließend gelöscht.

Dafür braucht es eine Gladys-Version, die an den Geräten der integrierten Tasmota-Integration einen Button Migrieren zeigt (GladysAssistant/Gladys#3256). Bis dahin können beide Integrationen nebeneinander laufen.

  1. Verbinden Sie diese Integration mit demselben Broker wie die integrierte: Option 1, in Block 1 Adresse und Zugangsdaten des Brokers der Gladys-MQTT-Integration. Beide Integrationen können gleichzeitig dieselben Geräte hören, an den Geräten ändert sich nichts. HTTP-Geräte: tragen Sie ihre Adressen in Block 3 ein.

  2. Fügen Sie das Gerät im Reiter Erkennung hinzu und behalten Sie das integrierte vorerst.

  3. Migrieren Sie sofort. Zeichnen beide Geräte parallel Zustände auf, behält Gladys den alten Verlauf nur bis zum ersten Zustand des neuen Geräts: Die in der Zwischenzeit doppelt aufgezeichneten Zustände werden gelöscht. Je länger Sie warten, desto länger dieser Zeitraum.

  4. Öffnen Sie die integrierte Tasmota-Integration, Reiter Meine Geräte, und klicken Sie am Gerät auf Migrieren. Wählen Sie seine neue Version: Die Liste gruppiert die Geräte nach Integration und zeigt ihren Raum.

  5. Prüfen Sie die Zuordnung der Funktionen und bestätigen Sie. Die meisten werden automatisch zugeordnet (Relais, Lampen, Leistung, Spannung, Strom, Energie heute, Temperatur, Luftfeuchtigkeit…). Zwei Fälle ordnen Sie von Hand zu:

    • Energie gesamt: Ordnen Sie sie Energy total zu. Gladys weist darauf hin, dass die Typen abweichen (energy in der integrierten Integration, index hier, der Typ, auf dem die Energieüberwachung beruht); die Werte in kWh sind gleich, Sie können bestätigen.
    • Eine als Schalter erkannte Lampe: Die integrierte Integration kennt nur wenige Lampenmodule, die anderen kamen als Schalter an. Diese Integration erkennt die Lampe: Ordnen Sie Switch der Light zu.

    Eine nicht zugeordnete Funktion verliert ihren Verlauf, und die Szenen, die sie nutzen, müssen angepasst werden.

  6. Bei einem großen Verlauf dauert die Migration einige Minuten: Verfolgen Sie sie unter Einstellungen → Aufgaben. Bricht sie ab, starten Sie sie erneut: Sie verschiebt nur, was übrig ist.

Sind alle Geräte migriert, hat die integrierte Tasmota-Integration kein Gerät mehr.

Aktionen der Konfigurationsseite​

  • Verbindung testen — Broker-Status und Anzahl der Geräte online.
  • Option 2 — Befehl für die Geräte abrufen — die Konsolenzeile für den eigenen Broker.
  • HTTP-Gerät hinzufügen / IP-Bereich scannen — Geräte per HTTP finden (höchstens 1024 Adressen).
  • Lampe identifizieren — die Lampe blinkt zweimal und kehrt in ihren Zustand zurück. Relais blinken nie (sie können eine Heizung steuern).
  • Befehl senden — beliebiger Tasmota-Befehl, die Antwort erscheint unter der Schaltfläche.
  • Gerät neu starten.
  • Gerät auf MQTT umstellen — sendet MqttHost, MqttPort, MqttUser, MqttPassword.

Szenen​

In der Kategorie Integrationen des Szeneneditors (Gladys 5.1 oder neuer):

AuslöserNötige Tasmota-EinstellungVariablen
Tasmota-Taste gedrücktSetOption73 1 (Tasten von den Relais entkoppelt)button, action
Tasmota-Schaltereingang geändertSetOption114 1 (Schalter von den Relais entkoppelt)switch, action
RF-Code empfangeneine RF Bridge (RfReceived)code, rf_key
IR-Code empfangenein IR-Empfänger (IrReceived)code, protocol
Tasmota-Gerät online / offlinekeine (LWT per MQTT, fehlgeschlagene Abfragen per HTTP)status

Jeder Filter ist optional: Leer gelassen passt er auf alles. Lesen Sie die Werte in den folgenden Aktionen z. B. mit {{triggerEvent.data.code}}.

Aktionen: Tasmota-Befehl senden (Ausgaben answered und response), Relais zeitweise einschalten (das Gerät schaltet es selbst aus, bis zu 360 s), Tasmota-Lampe blinken lassen, Tasmota-Gerät neu starten.

Die Zustände selbst (ein Relais, eine Temperatur…) sind normale Gerätefunktionen: Nutzen Sie dafür den Standard-Auslöser „Gerätezustand“ und die Aktion „Gerät steuern“ von Gladys.

Dashboard​

  • Tasmota-Geräte — Anzahl der Geräte, online und offline, Broker-Verbindung, Zustand jedes Geräts, eine Schaltfläche Aktualisieren.
  • Tasmota-Gerät — wählen Sie ein Gerät: seine wichtigsten Live-Werte, IP, Firmware, WLAN-Signal, Laufzeit sowie die Schaltflächen Umschalten, Identifizieren (Lampen) und Neustart.
  • Tasmota-Energie — wählen Sie ein Messgerät: Leistungskurve über 24 Stunden, Live-Leistung, Spannung, Strom, Energie heute, gestern und gesamt.

Fehlerbehebung​

  • Nichts in der Erkennung (MQTT): Prüfen Sie, dass die Broker-URL die LAN-IP nutzt und die Geräte in ihrer Konsole „MQTT connected“ anzeigen. Klicken Sie im Reiter Erkennung auf Scannen: Jedes bekannte Gerät wird erneut abgefragt.
  • Ein Gerät verlangt ein Passwort (HTTP): Tragen Sie Web-Benutzer und -Passwort in der Konfiguration oder in den Feldern der Aktionen Hinzufügen / Scannen ein.
  • Tasten lösen keine Szenen aus: Senden Sie SetOption73 1 an das Gerät (und SetOption114 1 für Schaltereingänge).
  • Logs: Öffnen Sie die Logs der Integration in Gladys; LOG_LEVEL=debug liefert alle Details.

Konfigurationseinstellungen​

Diese Einstellungen fragt Tasmota in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Schritt 1 — Wählen Sie, wie sich Ihre Geräte verbindensectionNeinOption 1: Sie haben bereits einen MQTT-Broker (z. B. den der Gladys-MQTT-Integration): Füllen Sie Block 1 mit seiner Adresse und seinen Zugangsdaten aus. Option 2: Sie haben keinen Broker: Die Integration stellt einen eigenen Mosquitto-Container bereit, füllen Sie nur Block 2 aus. Option 3: kein MQTT, die Geräte werden per HTTP gelesen: Füllen Sie nur Block 3 aus. Die Blöcke der anderen Optionen werden ignoriert und können leer bleiben.
VerbindungsmodusselectJa
Block 1 — Mein vorhandener MQTT-Broker (nur Option 1)sectionNeinAdresse und Zugangsdaten Ihres Brokers. Mit dem Broker der Gladys-MQTT-Integration: mqtt://<IP von Gladys>:1883 sowie Benutzer und Passwort von der Seite dieser Integration. Verwenden Sie die LAN-IP, nicht localhost: Die Integration läuft in einem eigenen Container. Ihre Tasmota-Geräte müssen auf denselben Broker zeigen (Configuration > MQTT auf jedem Gerät).
Broker-URLstringNein
Broker-BenutzerstringNein
Broker-PasswortsecretNein
Block 2 — Eigener Broker der Integration (nur Option 2)sectionNeinNichts zu installieren: Beim Speichern startet die Integration einen eigenen Mosquitto-Container. Ihre Geräte verbinden sich mit {{gladys_host}}, Port {{port:mqtt}}, Benutzer tasmota, mit dem Passwort unten (leer lassen, um eines zu erzeugen). Führen Sie dann die Aktion „Befehl für die Geräte abrufen“ aus: Sie liefert die Zeile für die Konsole jedes Tasmota-Geräts.
Passwort der GerätesecretNeinOptional: leer lassen, um eines zu erzeugen.
MQTT-Topics (Optionen 1 und 2)sectionNeinBehalten Sie den Standard, außer Sie haben das Full Topic Ihrer Geräte geändert.
Tasmota-FullTopicselectJa
Block 3 — HTTP-Geräte (Option 3, optional mit Optionen 1 und 2)sectionNeinPer HTTP gelesene Geräte, alle paar Sekunden. Pflicht bei Option 3; bei Optionen 1 und 2 nur für Geräte ohne MQTT. Listen Sie ihre Adressen auf (oder nutzen Sie die Aktion „IP-Bereich scannen“). Web-Benutzer und -Passwort: nur wenn auf den Geräten ein Web-Passwort gesetzt ist.
HTTP-AdressenstringNeinIPs, Hostnamen oder Bereiche, durch Kommas getrennt.
Web-BenutzerstringNein
Web-PasswortsecretNein
HTTP-Aktualisierungsintervall (s)numberNeinWie oft HTTP-Geräte gelesen werden (MQTT-Geräte senden ihre Änderungen).

So installierst du Tasmota in Gladys​

  1. Öffne in Gladys Integrationen: Tasmota erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/gboulvin/gladys-tasmota:1.0.3) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/gboulvin/Gladys-Tasmota.

Tasmota benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen​

Tasmota ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von gboulvin veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂