Diese Dokumentation beschreibt immer die neueste Version des Moduls, aktuell 1.0.1 im Kanal Beta.
Bindet Geräte mit Tasmota-Firmware über MQTT ein. Das Gerät beschreibt sich über die Discovery selbst, Sensoren und Energiewerte entstehen automatisch aus der Telemetrie.
Inhaltsverzeichnis
1. Voraussetzungen
- mindestens IPS Version 8.1
- MQTT-Server oder MQTT-Client in IP-Symcon
- Tasmota-Geräte mit eingerichtetem MQTT und aktiver Discovery (
SetOption19 0, Standard)
2. Funktionsumfang
- Relais, Licht (Dimmer, Farbe, Farbtemperatur, Weiß), Rollläden, Taster und Schalter
- Sensoren und Energiewerte, auch für Sensoren ohne eigene Unterstützung
- Spezialhardware, die das Modul an der Selbstauskunft des Geräts erkennt, erweiterbar über den Funktionskatalog (Beschreibung und Voraussetzungen in der README des Moduls):
- Fingerabdrucksensor AS608 mit Namen zu den IDs, Anlernen und Löschen
- Lüfter Sonoff iFan02 und iFan03 mit Lüfterstufen
- LED-Streifen WS2812 mit Pixelanzahl, Überblendung, Geschwindigkeit und Lichtprogrammen
- IR-Empfänger mit Protokoll, Bits, Daten und Hash des zuletzt empfangenen Codes
- Anwesenheitsradar HLK-LD2410 mit Entfernungen, Energien, Haltezeit und Empfindlichkeit (nur mit einer Firmware, die den Treiber enthält)
- Geräte mit Energiemessung, mit den Leistungsgrenzen (MaxPower)
- Port-Erweiterungen MCP230xx und PCF8574 sowie PWM-Treiber PCA9685 (nur mit einer Firmware, die die Treiber enthält)
- Erreichbarkeit des Geräts und WLAN-Qualität
- Konfigurator, der Geräte über MQTT findet
Die einzelnen Funktionen stehen bei den Instanzen unter “Enthaltene Module” und in der README des jeweiligen Moduls.
3. Enthaltene Module
- Tasmota Device V2
- Bindet ein Tasmota-Gerät ein und legt Variablen für Relais, Licht, Rollläden, Taster, Schalter, Sensoren und Energie an.
- Erkennt Spezialhardware an der GPIO-Belegung und legt deren Variablen und Befehle an (Funktionskatalog).
- Befehle für Skripte: beliebiger Tasmota-Befehl, Zustand abfragen, Discovery anfordern.
- Tasmota Konfigurator V2
- Listet die Geräte, die ihre Discovery-Nachricht gesendet haben, und legt dafür Tasmota-V2-Instanzen an.
4. Installation
Die Installation erfolgt über den IP-Symcon Module Store.
5. Konfiguration in IP-Symcon
Zuerst den MQTT-Server oder den MQTT-Client einrichten. Danach den Tasmota Konfigurator V2 anlegen, ihn mit dem MQTT-Parent verbinden und mit “Geräte suchen” die Discovery der Geräte anfordern. Aus der Liste lassen sich Instanzen anlegen. Alternativ legt man eine Tasmota-V2-Instanz von Hand an und trägt das Topic ein.
Taster und Schalter am Gerät brauchen keine Einstellung. Nur wenn sie in IP-Symcon als Auslöser dienen sollen, schaltet man am Gerät SetOption73 (Taster) und SetOption114 (Schalter) ein. Dann schalten sie das Relais nicht mehr selbst, Einzelheiten stehen in der README des Moduls.
Die Module laufen unabhängig von der Bibliothek IPS-Tasmota und können parallel zu ihr betrieben werden.
6. Spenden
Dieses Modul ist für die nicht kommerzielle Nutzung kostenlos, Schenkungen als Unterstützung für den Autor werden hier akzeptiert:
7. Lizenz
Changelog
Alle Versionen dieses Moduls, die neueste oben.
Version 1.0.1
- Neu: Das Anwesenheitsradar HLK-LD2410 wird erkannt und bekommt Entfernungen, Energien, Haltezeit und Empfindlichkeit als Variablen. Die Werte für Haltezeit und Empfindlichkeit sind steuerbar, ungültige Eingaben werden nicht gesendet. Es ist noch nicht an einem echten Gerät geprüft.
- Fix: Variablen aus Listen von Sensorwerten tragen jetzt eine Nummer in der Beschriftung (zum Beispiel "Distance 1" bis "Distance 3") und heißen nicht mehr alle gleich.
Version 1.0 Beta
- Neu: Erste Fassung: Relais, Licht, Rollläden, Taster, Schalter, Sensoren, Energie und Erreichbarkeit, gesteuert durch die Discovery des Geräts.
- Neu: Sensoren und Energiewerte entstehen automatisch aus der Telemetrie, auch für Sensoren ohne eigene Unterstützung.
- Neu: Spezialhardware wird an der GPIO-Belegung erkannt und bekommt ihre Variablen und Befehle automatisch. Im Funktionskatalog stehen der Lüfter Sonoff iFan02/iFan03 (Lüfterstufe 0 bis 3) und der Fingerabdrucksensor AS608 mit ID, Name zur ID (Liste in der Instanz), Treffergenauigkeit, Anzahl sowie Anlernen und Löschen.
- Neu: Neue Instanzen fragen beim Anlegen sofort den kompletten Zustand und die Hardware des Geräts ab, auch wenn sie über den Konfigurator angelegt werden.
- Neu: Mit der Option "Systemvariablen" zeigt die Instanz auch Modul und Group-Topic des Geräts.
- Neu: Port-Erweiterungen MCP230xx und PCF8574 sowie der PWM-Treiber PCA9685 werden an ihren Meldungen erkannt. Je Pin entsteht eine Variable, Ausgänge und PWM-Kanäle sind steuerbar.
- Neu: LED-Streifen (WS2812) werden an der GPIO-Belegung erkannt und bekommen Pixelanzahl, Überblendung, Geschwindigkeit und eine Auswahl der Lichtprogramme (Schema). Das Schema ist bei allen Lichtern eine Auswahl statt einer Zahl.
- Neu: Neue Funktion TASV2SendCommandWait: sendet einen Befehl und wartet auf die Antwort des Geräts, für Skripte, die das Ergebnis sofort brauchen.
- Neu: Geräte mit IR-Empfänger bekommen automatisch Variablen für Protokoll, Bits, Daten und Hash des zuletzt empfangenen IR-Codes.
- Neu: Geräte mit Energiemessung bekommen automatisch die steuerbaren Variablen für die Leistungsgrenzen (MaxPower, MaxPowerHold, MaxPowerWindow).
- Neu: Rollläden haben eine Variable "Sperre" (ShutterLock), steuerbar.
- Neu: Neue Variable "Zustand beim Einschalten" (PowerOnState) für jedes Gerät, steuerbar mit den Werten 0 bis 5. Achtung: Wert 4 sperrt das Schalten der Relais.
- Neu: Der Konfigurator findet Geräte über MQTT, ohne einen IP-Bereich zu durchsuchen.