Deckenventilator – Wilkware

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. Einrichten der Instanzen in Symcon

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

Konfigurationsseite:

Einstellungsbereich:

📳 Geräteinformationen …

Name	Beschreibung
MQTT Base Topic	Ist 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 Topic	Ist 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:

Aktion	Beschreibung
AKTUALISIEREN	Lö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 und Darstellungen

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

Name	Typ	Beschreibung
Status	String	Verfügbarkeitsstatus: Online (online), Offline (offline) oder Undefiniert (undefine)
Licht	Boolean	Licht schalten (AN, AUS)
Farbtemperatur	Integer	Farbtemperatur von 0 bis 1000 in drei Stufen: Kühl, Neutral, Warm
Ventilator	Boolean	Ventilator schalten (AN, AUS)
Geschwindigkeit	Integer	Stufen von 1 bis 6 (schaltet den Ventilator bei Bedarf mit ein)
Richtung	String	‘Vorwärts’ oder ‘Rückwärts’
Verbleibende Zeit	Integer	Restlaufzeit des eingestellten Timers (0 bis 540 min)
Piepton	Boolean	Bei jeder Schaltaktion einen Ton ausgeben (AN, AUS)

Statt Profilen werden Darstellungen verwendet, die das Modul direkt an den Variablen setzt.

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. Visualisierung

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

7. PHP-Befehlsreferenz

Das Modul stellt keine direkten Funktionsaufrufe zur Verfügung.

8. 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 ;-)

Spenden

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

Lizenz

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