Suche

    Deckenventilator

    Dokumentation direkt aus GitHub Wilkware/LocalTuya ↗

    Version Product Version License Actions

    Das Modul bietet die Möglichkeit, mit einem kompatiblen Deckenventilator über das lokale Netzwerk zu kommunizieren.

    1. Funktionsumfang

    Das Modul kommuniziert via MQTT mit dem Deckenventilator und bietet neben dem Auslesen aller Geräteinformationen auch das Steuern des Ventilators über die Statusvariablen.
    Eine genaue Beschreibung der für den Deckenventilator verfügbaren Befehlsumfang kann man im Tuya Developer Portal einsehen.

    2. Voraussetzungen

    • Symcon ab Version 8.1
    • tuya2mqtt ab Version 1.5.0 (für Bridge-Status und den Abruf aller Werte beim Start)

    Notwendige Voraussetzung ist eine funktionsfähige und laufende Installation von Tuya2Mqtt . Dessen Installation, Konfiguration und der Betrieb ist hier beschrieben: README .
    Dort findet man ebenfalls die unterstützten Tuya Geräte.

    Getestet mit meinem Deckenventilator WINDCALM von CREATE.

    3. Installation

    • Über den Modul Store die Bibliothek LocalTuya installieren.
    • Alternativ über das Modul Control folgende URL hinzufügen.
      https://github.com/Wilkware/LocalTuya oder git://github.com/Wilkware/LocalTuya.git

    4. Einrichtung

    • Unter ‘Instanz hinzufügen’ ist das Deckenventilator-Modul (Alias: Tuya Deckenventilator) unter dem Hersteller ‘(Geräte)’ aufgeführt.

    Konfigurationsseite:

    Einstellungsbereich:

    📳 Geräteinformationen …

    NameBeschreibung
    MQTT Base TopicIst das grundlegende Themenpräfix, unter dem alle spezifischen Subtopics für Nachrichten in einem MQTT-System organisiert werden. Standardmäßig ist der Präfix auf ’tuya2mqtt’ vorbelegt. Er muss dem topic aus der config.json von tuya2mqtt entsprechen, darf mehrstufig sein (z. B. ‘home/tuya’) und ein abschließender / wird ignoriert.
    MQTT TopicIst der eindeutige Geräte-Pfad, der zum Veröffentlichen und Abonnieren von Nachrichten verwendet wird. HINWEIS: tuya2mqtt bildet den Pfad aus dem Gerätenamen in Kleinbuchstaben, Leerzeichen sowie die Zeichen +, # und / werden durch _ ersetzt (z. B. ‘Wohnzimmer Lampe’ → ‘wohnzimmer_lampe’). Ohne Namen wird die Geräte-ID verwendet.

    Aktionsbereich:

    AktionBeschreibung
    AKTUALISIERENLöst eine Nachricht aus, welche versucht alle Status(Geräte)informationen vom Gerät abzurufen.

    Da tuya2mqtt Werte nur noch bei Änderungen veröffentlicht, fordert das Modul beim Systemstart und nach dem Übernehmen der Konfiguration automatisch alle aktuellen Werte an (get-states).

    5. Statusvariablen

    Die Statusvariablen werden automatisch angelegt. Das Löschen einzelner kann hilfreich sein, z.B. wenn entsprechender Befehl/Status nicht vom Ventilator unterstützt wird.

    NameTypBeschreibung
    StatusStringVerfügbarkeitsstatus des Gerätes
    LichtBooleanLicht schalten
    FarbtemperaturIntegerFarbtemperatur des Lichts
    VentilatorBooleanVentilator schalten
    GeschwindigkeitIntegerGeschwindigkeitsstufe des Ventilators (schaltet den Ventilator bei Bedarf mit ein)
    RichtungStringDrehrichtung des Ventilators
    Verbleibende ZeitIntegerRestlaufzeit des eingestellten Timers
    PieptonBooleanBei jeder Schaltaktion einen Ton ausgeben

    Hinweis: Der Status wird zusätzlich über den Bridge-Status von tuya2mqtt (<Base Topic>/bridge/status) abgesichert: Meldet die Bridge ‘offline’ (z. B. per MQTT Last Will nach einem Absturz), wird der Status auf ‘offline’ gesetzt.

    6. Darstellungen

    Die Darstellungen werden direkt an den Statusvariablen hinterlegt, es werden keine Profile angelegt.

    VariableDarstellungWerte
    StatusWertanzeigeOnline (online), Offline (offline), Undefiniert (undefine)
    LichtSchalterAn / Aus
    FarbtemperaturSchieberegler0 – 1000 (Schrittweite 500): Kühl (0), Neutral (500), Warm (1000)
    VentilatorSchalterAn / Aus
    GeschwindigkeitSchiebereglerStufe 1 – 6 (Schrittweite 1)
    RichtungAufzählungVorwärts (forward), Rückwärts (reverse)
    Verbleibende ZeitSchieberegler0 – 540 min (Schrittweite 1)
    PieptonSchalterAn / Aus

    7. Visualisierung

    Man kann die Instanz bzw. Statusvariablen direkt in die Visualisierung verlinken.

    8. Befehlsreferenz

    Das Modul stellt keine direkten Funktionsaufrufe zur Verfügung.

    9. Versionshistorie

    v2.3.20261002

    • NEU: Profile durch Darstellungen ersetzt
    • NEU: Bridge-Status von tuya2mqtt wird ausgewertet (Status ‘offline’ bei Absturz der Bridge)
    • NEU: Automatischer Abruf aller Werte beim Systemstart und nach Übernahme der Konfiguration (get-states)
    • NEU: Mehrstufiges Base Topic möglich, abschließender / wird ignoriert
    • FIX: Beim Ändern der Geschwindigkeit wird der Ventilator mit eingeschaltet, da das Gerät ihn sonst trotz Anlaufen weiter als aus meldet
    • FIX: Empfangsfilter präzisiert (nur Geräte-Topics und Bridge-Status)
    • FIX: Übersetzung der Darstellungen (Farbtemperatur, Richtung, Geschwindigkeit) korrigiert
    • FIX: Dokumentation überarbeitet und Schreibfehler korrigiert

    v2.2.20260319

    • FIX: Kompatibilität für IPS größer 8.2 hergestellt

    v2.1.20250926

    • FIX: Abruf aller Daten korrigiert (get-states)
    • FIX: Fehler bei Verarbeitung des Payloads durch Umstellung auf IPSModuleStrict korrigiert

    v2.0.20250916

    • NEU: Projektumstrukturierung hin zu einer globalen CI/CD-Pipeline
    • NEU: Kompatibilität auf IPS 8.1 hoch gesetzt
    • NEU: Umstellung auf IPSModuleStrict
    • FIX: Bibliotheksfunktionen angeglichen

    v1.1.20250802

    • NEU: Konfigurationsformular überarbeitet
    • NEU: Continuous Integration mit Check Style, Static Code Analysis und Unit Tests eingeführt
    • NEU: Debugging Funktionen komplett überarbeitet
    • FIX: Mqtt Topic test korrigiert
    • FIX: Dokumentation für PHP Static Analysis komplett überarbeitet
    • FIX: Bibliotheksfunktionen überarbeitet in Vorbereitung auf IPSModuleStrict

    v1.0.20250125

    • NEU: Initialversion

    Entwickler

    Seit nunmehr über 10 Jahren fasziniert mich das Thema Haussteuerung. In den letzten Jahren betätige ich mich auch intensiv in der Symcon Community und steuere dort verschiedenste Skript und Module bei. Ihr findet mich dort unter dem Namen @pitti ;-)

    GitHub

    Spenden

    Die Software ist für die nicht kommerzielle Nutzung kostenlos, über eine Spende bei Gefallen des Moduls würde ich mich freuen.

    PayPal

    Lizenz

    Namensnennung - Nicht-kommerziell - Weitergabe unter gleichen Bedingungen 4.0 International

    Licence