Passa al contenuto

← Guida introduttiva | Sommario | Avanti: Metodi di controllo →

Configurazione

File di configurazione (dimmerlink.json)

Il file di configurazione è memorizzato nel filesystem dell'ESP32 in /dimmerlink.json. È possibile modificarlo tramite Consoles > Manage File System > Edit.

Configurazione minima (singolo dispositivo, 1 canale)

json
{
  "devices": [
    {"addr": "0x50", "label": "Dimmer", "channels": 1}
  ],
  "presets": {
    "night": 10,
    "low": 25,
    "mid": 50,
    "high": 75,
    "full": 100
  }
}

Configurazione multicanale (1 dispositivo, 2 canali)

json
{
  "devices": [
    {"addr": "0x50", "label": "Lamp", "channels": 2}
  ],
  "presets": {
    "night": 10,
    "full": 100
  }
}

Vengono creati due cursori: Lamp Ch1 e Lamp Ch2, controllati dai comandi DimmerLink_Lamp1 e DimmerLink_Lamp2.

Più dispositivi sullo stesso bus I2C

json
{
  "devices": [
    {"addr": "0x50", "label": "Kitchen", "channels": 1},
    {"addr": "0x51", "label": "Bedroom", "channels": 1},
    {"addr": "0x52", "label": "Hall", "channels": 2}
  ],
  "presets": {
    "night": 10,
    "evening": 40,
    "full": 100
  }
}

Ogni dispositivo ottiene il proprio cursore, comandi e voce di telemetria.

Parametri di configurazione

Parametro Tipo Obbligatorio Predefinito Descrizione
addr string Sì "0x50" Indirizzo I2C in formato esadecimale
label string Sì "DimmerLink" Nome del dispositivo (usato nei comandi e nell'interfaccia web)
channels integer No 1 Numero di canali del dimmer (1–4)
presets object No (vedi sopra) Livelli di luminosità con nome

Regole di denominazione delle etichette

Le etichette vengono utilizzate nei nomi dei comandi di Tasmota. A causa del modo in cui Tasmota analizza i comandi:

Etichetta OK? Perché
Kitchen Sì Nessuna cifra finale
DimmerA Sì Termina con una lettera
Dimmer1 No Tasmota legge «1» come indice del comando, non come parte del nome
Room2 No Stesso problema — «2» diventa l'indice
Lamp_North Sì Il trattino basso e la lettera sono accettati

Se si utilizza un'etichetta che termina con una cifra, il driver stamperà un avviso all'avvio:

plaintext
DimmerLink WARNING: label 'Room2' ends with digit — commands will not work. Rename it.

Configurazione degli indirizzi I2C

Ogni dispositivo DimmerLink viene fornito con l'indirizzo I2C predefinito 0x50. Per utilizzare più dispositivi sullo stesso bus, ognuno deve avere un indirizzo univoco.

Verifica dei dispositivi sul bus

Aprire Consoles > Berry Scripting Console ed eseguire:

berry
import DimmerLink
DimmerLink.scan()

Output:

plaintext
I2C bus 0:
  0x50 - DimmerLink v1 (READY, 50Hz, level=0%)
Found 1 DimmerLink device(s)

Cambiare l'indirizzo di un dispositivo

  1. Collegare il dispositivo che si desidera riconfigurare
  2. Nella console Berry, eseguire:
berry
import DimmerLink
DimmerLink.change_addr(0x50, 0x51)

Output:

plaintext
DimmerLink at 0x50: v1, READY
Writing new address 0x51... OK
Verifying 0x51... OK
Address changed: 0x50 -> 0x51
>>> Update dimmerlink.json: change addr to 0x51
  1. Il cambio di indirizzo è immediato e salvato nella memoria flash interna del dispositivo
  2. Togliere l'alimentazione, collegare il dispositivo successivo, accendere, ripetere se necessario
  3. Aggiornare /dimmerlink.json con i nuovi indirizzi
  4. Riavviare Tasmota

Passo dopo passo: configurare 3 dispositivi

plaintext
1. Connect Device A only → it responds at 0x50 (default)
   Berry console: DimmerLink.change_addr(0x50, 0x51)
   → Device A is now at 0x51
2. Power off. Connect Device B only → it responds at 0x50
   Berry console: DimmerLink.change_addr(0x50, 0x52)
   → Device B is now at 0x52
3. Power off. Connect Device C (keep at default 0x50)
4. Power off. Connect all three devices together.
5. Edit dimmerlink.json:
   {
     "devices": [
       {"addr": "0x50", "label": "DeviceC", "channels": 1},
       {"addr": "0x51", "label": "DeviceA", "channels": 1},
       {"addr": "0x52", "label": "DeviceB", "channels": 1}
     ]
   }
6. Restart Tasmota.
7. Verify: DimmerLink.scan()
   0x50 - DimmerLink v1 (READY, 50Hz)
   0x51 - DimmerLink v1 (READY, 50Hz)
   0x52 - DimmerLink v1 (READY, 50Hz)
   Found 3 DimmerLink device(s)

Dimenticato l'indirizzo di un dispositivo?

berry
import DimmerLink
DimmerLink.scan()

Questo mostra sempre gli indirizzi reali sul bus, indipendentemente dal contenuto del file di configurazione.

Ottenere le informazioni del dispositivo

Se il driver è già caricato, è possibile ispezionare un'istanza in esecuzione:

berry
global._dimmerlink[0].info()

Output:

plaintext
DimmerLink "Kitchen" at 0x50 (bus 0)
  Channels:  1
  Levels:    Ch1=50%
  Power:     ON (relay 6)
  Curve:     Ch1=LINEAR
  Fade:      0 (0.0s)
  AC freq:   50 Hz
  Firmware:  v1
  Ready:     Yes
  preinit:   DimmerLink(0x50, "Kitchen", 1)

Configurazione web di Tasmota

Il driver DimmerLink utilizza l'interfaccia web standard di Tasmota. Non sono necessarie pagine di configurazione speciali.

File di configurazione (dimmerlink.json) Configurazione degli indirizzi I2C Configurazione web di Tasmota