Se rendre au contenu

← Démarrage rapide | Sommaire | Suivant : Méthodes de contrôle →

Configuration

Fichier de configuration (dimmerlink.json)

Le fichier de configuration est stocké sur le système de fichiers ESP32 à l'emplacement /dimmerlink.json. Vous pouvez le modifier via Consoles > Manage File System > Edit.

Configuration minimale (un seul appareil, 1 canal)

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

Configuration multi-canal (1 appareil, 2 canaux)

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

Cela crée deux curseurs : Lamp Ch1 et Lamp Ch2, contrôlés par les commandes DimmerLink_Lamp1 et DimmerLink_Lamp2.

Plusieurs appareils sur le même 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
  }
}

Chaque appareil obtient son propre curseur, ses commandes et son entrée de télémétrie.

Paramètres de configuration

Paramètre Type Obligatoire Défaut Description
addr string Oui "0x50" Adresse I2C au format hexadécimal
label string Oui "DimmerLink" Nom de l'appareil (utilisé dans les commandes et l'interface web)
channels integer Non 1 Nombre de canaux de gradation (1–4)
presets object Non (voir ci-dessus) Niveaux de luminosité nommés

Règles de nommage des labels

Les labels sont utilisés dans les noms des commandes Tasmota. En raison de la façon dont Tasmota analyse les commandes :

Label OK ? Pourquoi
Kitchen Oui Pas de chiffre final
DimmerA Oui Se termine par une lettre
Dimmer1 Non Tasmota lit « 1 » comme index de commande, pas comme partie du nom
Room2 Non Même problème — « 2 » devient l'index
Lamp_North Oui Tiret bas et lettre sont acceptés

Si vous utilisez un label se terminant par un chiffre, le pilote affichera un avertissement au démarrage :

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

Configuration des adresses I2C

Chaque appareil DimmerLink est livré avec l'adresse I2C par défaut 0x50. Pour utiliser plusieurs appareils sur le même bus, chacun doit avoir une adresse unique.

Vérifier ce qui est sur le bus

Ouvrez Consoles > Berry Scripting Console et exécutez :

berry
import DimmerLink
DimmerLink.scan()

Sortie :

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

Changer l'adresse d'un appareil

  1. Connectez l'appareil que vous souhaitez reconfigurer
  2. Dans la console Berry, exécutez :
berry
import DimmerLink
DimmerLink.change_addr(0x50, 0x51)

Sortie :

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. Le changement d'adresse est immédiat et enregistré dans la mémoire flash interne de l'appareil
  2. Coupez l'alimentation, connectez l'appareil suivant, remettez sous tension, répétez si nécessaire
  3. Mettez à jour /dimmerlink.json avec les nouvelles adresses
  4. Redémarrez Tasmota

Étape par étape : configuration de 3 appareils

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)

Vous avez oublié l'adresse d'un appareil ?

berry
import DimmerLink
DimmerLink.scan()

Cela affiche toujours les adresses réelles sur le bus, quel que soit le contenu du fichier de configuration.

Obtenir les informations d'un appareil

Si le pilote est déjà chargé, vous pouvez inspecter une instance en cours d'exécution :

berry
global._dimmerlink[0].info()

Sortie :

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)

Configuration web Tasmota

Le pilote DimmerLink utilise l'interface web standard de Tasmota. Aucune page de configuration spéciale n'est nécessaire.

Fichier de configuration (dimmerlink.json) Configuration des adresses I2C Configuration web Tasmota