← Tasmota-Integration | Inhalt | Next: Build & Flash →
Übersicht nativer Treiber — DimmerLink Tasmota
Treiber: xdrv_94_dimmerlink.ino (XDRV_94 / XI2C_100)
Plattformen: ESP32, ESP8266
Was ist der native Treiber?
Der native DimmerLink C-Treiber (xdrv_94_dimmerlink.ino) integriert den MCU TRIAC AC-Dimmer-Controller als kompilierten Treiber in Tasmota. Im Gegensatz zum Berry-Script-Treiber wird der native Treiber direkt in das Firmware-Binary kompiliert und erfordert kein Hochladen von Dateien oder eine autoexec.be-Konfiguration. Er aktiviert sich beim Start automatisch, sobald ein kompatibles DimmerLink-Gerät am I2C-Bus erkannt wird.
Wesentliche Unterschiede zum Berry-Treiber
| Aspekt | Nativer C-Treiber | Berry-Treiber |
|---|---|---|
| Aktivierung | Automatisch — kompiliert, erkennt I2C beim Start | Manuell — Dateien hochgeladen, in autoexec.be konfiguriert |
| Plattform | ESP32 und ESP8266 | Nur ESP32 (Berry auf ESP8266 nicht verfügbar) |
| Konfiguration | user_config_override.h zur Kompilierzeit |
/dimmerlink.json zur Laufzeit |
| Befehlspräfix | Dl (z. B. DlDim, DlCurve) |
DimmerLink (z. B. DimmerLink_Kitchen) |
| Benannte Instanzen | Nicht unterstützt — Geräte als Dev1, Dev2 indiziert | Unterstützt — jedes Gerät hat eine Bezeichnung |
| Auto-Scan | Vollständiger I2C-Bus-Scan über alle Busse (0x08–0x77) | Manuelle Adresskonfiguration |
Hauptfunktionen
- Bis zu 4 Geräte, jedes mit bis zu 4 Kanälen (insgesamt 16 Kanäle)
- Web-UI Helligkeits-Schieberegler und Sensoranzeige
- MQTT-Telemetrie mit JSON-Daten pro Kanal
- HTTP API zur Fernsteuerung über
curloder Automatisierungssysteme - Drei Dimmkurven: LINEAR, RMS, LOG (pro Kanal)
- Hardware-Fade-Übergänge (0 bis 25,5 Sekunden)
- Temperaturüberwachung und Meldung des Thermoschutzstatus
- Automatische Netzfrequenzerkennung (50/60 Hz)
Anforderungen
| Kategorie | Details |
|---|---|
| Build-Tool | PlatformIO (CLI oder VS Code-Erweiterung) |
| MCU | ESP32 (beliebige Variante) oder ESP8266 |
| Hardware | DimmerLink-Gerät mit aktiviertem I2C-Modus |
| Verkabelung | SDA, SCL, GND, VCC mit 4,7 kOhm Pull-up-Widerständen |
Treiberdateien
| Datei | Zweck |
|---|---|
xdrv_94_dimmerlink.ino |
Treiber-Quellcode — im Verzeichnis tasmota/ ablegen |
user_config_override.h |
USE_DIMMERLINK-Define aktivieren |
Tip: Treiber-Quellcode herunterladen:
xdrv_94_dimmerlink.ino auf GitHub
Dokumentation
| Seite | Beschreibung |
|---|---|
| Build & Flash | PlatformIO-Einrichtung, Kompilierung, Flashen per USB und OTA |
| Befehle | Vollständige Befehlsreferenz — DlDim, DlCurve, DlFade, DlStatus, DlReset, DlRecalibrate, DlAddress |
| Web, MQTT & HTTP | Web-UI-Schieberegler, MQTT-Telemetrie-JSON, HTTP API-Endpunkte |
| Erweiterte Funktionen | Dimmkurven erklärt, Fade-Steuerung, Temperaturüberwachung, Multi-Geräte-Setup, Migration von Berry |
| Referenz | Fehlerbehebung, Fehlercodes, I2C-Registerkarte, Thermozustände |