Passa al contenuto

← Panoramica del driver Berry | Indice | Successivo: Configurazione →

Guida introduttiva

Cos'è DimmerLink?

DimmerLink è un driver Berry che collega l'hardware MCU TRIAC AC dimmer a Tasmota tramite I2C. Fornisce:

  • Cursori della luminosità nel pannello web di Tasmota
  • Controllo tramite comandi Tasmota (console, HTTP, MQTT)
  • Telemetria dei sensori (livello di luminosità, frequenza AC, temperatura)
  • Livelli di luminosità preimpostati (notte, basso, medio, alto, massimo)

Requisiti

Componente Dettagli
Firmware Tasmota tasmota32 o tasmota32-berry (qualsiasi build ESP32 con supporto Berry)
Hardware Scheda ESP32 + modulo/i MCU DimmerLink
Cablaggio I2C SDA, SCL, GND, VCC con resistenze pull-up da 4,7 kΩ su SDA e SCL
Pin I2C Devono essere configurati in Tasmota: Configurazione > Configura modulo

File del driver

Il driver è composto da 3 file:

File Scopo Dove trovarlo
DimmerLink.be Classe principale del driver — comunicazione I2C, comandi, interfaccia web, telemetria Obbligatorio
dimmerlink_loader.be Auto-loader — legge la configurazione, crea istanze, registra i preset Obbligatorio
dimmerlink.json Configurazione del dispositivo — indirizzi, etichette, canali, preset Generato automaticamente al primo avvio

Installazione

Passo 1: Configurare i pin I2C

Nell'interfaccia web di Tasmota: Configurazione > Configura modulo

Assegna due pin GPIO: - Un pin come I2C SDA - Un pin come I2C SCL

Salva e riavvia.

Passo 2: Caricare i file del driver

Vai su Console > Gestisci file system

Carica questi file (uno alla volta): 1. DimmerLink.be 2. dimmerlink_loader.be

Passo 3: Aggiungere ad autoexec.be

In Gestisci file system, apri autoexec.be per modificarlo (o crealo se non esiste).

Aggiungi questa riga alla fine:

berry
load('dimmerlink_loader.be')

Se autoexec.be contiene già altre righe, aggiungila semplicemente dopo di esse:

berry
# existing lines...
load('some_other_script.be')
# add DimmerLink loader
load('dimmerlink_loader.be')

Passo 4: Riavviare

Fai clic su Riavvia nell'interfaccia web di Tasmota oppure invia il comando:

plaintext
Restart 1

Passo 5: Verificare

Dopo il riavvio, apri la pagina principale di Tasmota. Dovresti vedere:

  • Un cursore della luminosità per ogni dispositivo DimmerLink
  • Dati del sensore che mostrano il livello di luminosità, la frequenza AC e la versione del firmware

Nella console (Console > Console), dovresti vedere:

plaintext
I2C: DimmerA detected on bus 0
DimmerLink: 1 device(s)

Cosa succede al primo avvio?

Quando il loader viene eseguito per la prima volta e non esiste alcun file dimmerlink.json:

  1. Scansiona tutti i bus I2C alla ricerca di dispositivi DimmerLink (identificati dal registro VERSION = 0x01)
  2. Crea un file di configurazione /dimmerlink.json con i dispositivi rilevati automaticamente
  3. Assegna le etichette automaticamente: DimmerA, DimmerB, DimmerC, ecc.
  4. Crea i preset predefiniti: notte (10%), basso (25%), medio (50%), alto (75%), massimo (100%)

Puoi modificare dimmerlink.json in seguito per personalizzare le etichette e le impostazioni.

Disinstallazione

Per rimuovere DimmerLink:

  1. Rimuovi load('dimmerlink_loader.be') da autoexec.be
  2. Elimina DimmerLink.be, dimmerlink_loader.be e dimmerlink.json dal file system
  3. Riavvia
Cos'è DimmerLink? Requisiti File del driver Installazione Cosa succede al primo avvio? Disinstallazione