← Integrazione Tasmota | Sommario | Next: Build & Flash →
Panoramica del driver nativo — DimmerLink Tasmota
Driver: xdrv_94_dimmerlink.ino (XDRV_94 / XI2C_100)
Piattaforme: ESP32, ESP8266
Cos'è il driver nativo?
Il driver C nativo di DimmerLink (xdrv_94_dimmerlink.ino) integra il controller dimmer AC MCU TRIAC in Tasmota come driver compilato. A differenza del driver con script Berry, il driver nativo viene compilato direttamente nel binario del firmware e non richiede il caricamento di file né la configurazione di autoexec.be. Si attiva automaticamente all'avvio quando viene rilevato un dispositivo DimmerLink compatibile sul bus I2C.
Differenze chiave rispetto al driver Berry
| Aspetto | Driver C nativo | Driver Berry |
|---|---|---|
| Attivazione | Automatica — compilato, rileva I2C all'avvio | Manuale — file caricati, configurati in autoexec.be |
| Piattaforma | ESP32 e ESP8266 | Solo ESP32 (Berry non disponibile su ESP8266) |
| Configurazione | user_config_override.h al momento della compilazione |
/dimmerlink.json in fase di esecuzione |
| Prefisso comando | Dl (es. DlDim, DlCurve) |
DimmerLink (es. DimmerLink_Kitchen) |
| Istanze con nome | Non supportato — dispositivi indicizzati come Dev1, Dev2 | Supportato — ogni dispositivo ha un'etichetta |
| Auto-scansione | Scansione completa del bus I2C su tutti i bus (0x08–0x77) | Configurazione manuale dell'indirizzo |
Funzionalità principali
- Fino a 4 dispositivi, ciascuno con fino a 4 canali (16 canali in totale)
- Cursori di luminosità e visualizzazione sensori nell'interfaccia web
- Telemetria MQTT con dati JSON per canale
- HTTP API per il controllo remoto tramite
curlo sistemi di automazione - Tre curve di dimmeraggio: LINEAR, RMS, LOG (per canale)
- Transizioni di dissolvenza hardware (da 0 a 25,5 secondi)
- Monitoraggio della temperatura e segnalazione della protezione termica
- Rilevamento automatico della frequenza AC (50/60 Hz)
Requisiti
| Categoria | Dettagli |
|---|---|
| Strumento di compilazione | PlatformIO (CLI o estensione VS Code) |
| MCU | ESP32 (qualsiasi variante) o ESP8266 |
| Hardware | Dispositivo DimmerLink con modalità I2C abilitata |
| Cablaggio | SDA, SCL, GND, VCC con resistenze di pull-up da 4,7 kOhm |
File del driver
| File | Scopo |
|---|---|
xdrv_94_dimmerlink.ino |
Sorgente del driver — inserire nella directory tasmota/ |
user_config_override.h |
Abilitare la definizione USE_DIMMERLINK |
Tip: Scarica il codice sorgente del driver:
xdrv_94_dimmerlink.ino su GitHub
Documentazione
| Pagina | Descrizione |
|---|---|
| Build & Flash | Configurazione di PlatformIO, compilazione, flash via USB e OTA |
| Comandi | Riferimento completo dei comandi — DlDim, DlCurve, DlFade, DlStatus, DlReset, DlRecalibrate, DlAddress |
| Web, MQTT & HTTP | Cursori dell'interfaccia web, JSON di telemetria MQTT, endpoint HTTP API |
| Funzionalità avanzate | Curve di dimmeraggio spiegate, controllo dissolvenza, monitoraggio temperatura, configurazione multi-dispositivo, migrazione da Berry |
| Riferimento | Risoluzione dei problemi, codici di errore, mappa dei registri I2C, stati termici |