Zum Inhalt springen

← Erste Schritte | Inhalt | Weiter: Steuerungsmethoden →

Konfiguration

Konfigurationsdatei (dimmerlink.json)

Die Konfigurationsdatei wird im ESP32-Dateisystem unter /dimmerlink.json gespeichert. Sie kann über Consoles > Manage File System > Edit bearbeitet werden.

Minimale Konfiguration (einzelnes Gerät, 1 Kanal)

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

Mehrkanalige Konfiguration (1 Gerät, 2 Kanäle)

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

Dadurch werden zwei Schieberegler erstellt: Lamp Ch1 und Lamp Ch2, gesteuert durch die Befehle DimmerLink_Lamp1 und DimmerLink_Lamp2.

Mehrere Geräte am selben I2C-Bus

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
  }
}

Jedes Gerät erhält einen eigenen Schieberegler, Befehle und Telemetrie-Eintrag.

Konfigurationsparameter

Parameter Typ Erforderlich Standard Beschreibung
addr string Ja "0x50" I2C-Adresse im Hex-Format
label string Ja "DimmerLink" Gerätename (wird in Befehlen und Web-UI verwendet)
channels integer Nein 1 Anzahl der Dimmerkanäle (1–4)
presets object Nein (siehe oben) Benannte Helligkeitsstufen

Benennungsregeln für Labels

Labels werden in Tasmota-Befehlsnamen verwendet. Aufgrund der Art, wie Tasmota Befehle analysiert:

Label OK? Warum
Kitchen Ja Keine abschließende Ziffer
DimmerA Ja Endet mit einem Buchstaben
Dimmer1 Nein Tasmota liest „1" als Befehlsindex, nicht als Teil des Namens
Room2 Nein Gleiche Problem — „2" wird zum Index
Lamp_North Ja Unterstrich und Buchstabe sind in Ordnung

Wenn ein Label mit einer Ziffer endet, gibt der Treiber beim Start eine Warnung aus:

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

I2C-Adressen einrichten

Jedes DimmerLink-Gerät wird mit der Standard-I2C-Adresse 0x50 geliefert. Um mehrere Geräte am selben Bus zu verwenden, muss jedes eine eindeutige Adresse haben.

Überprüfen, was am Bus vorhanden ist

Öffnen Sie Consoles > Berry Scripting Console und führen Sie aus:

berry
import DimmerLink
DimmerLink.scan()

Ausgabe:

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

Adresse eines Geräts ändern

  1. Verbinden Sie das Gerät, das neu konfiguriert werden soll
  2. Führen Sie in der Berry-Konsole aus:
berry
import DimmerLink
DimmerLink.change_addr(0x50, 0x51)

Ausgabe:

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. Die Adressänderung ist sofort wirksam und wird im internen Flash des Geräts gespeichert
  2. Trennen Sie die Stromversorgung, schließen Sie das nächste Gerät an, schalten Sie es ein, wiederholen Sie bei Bedarf
  3. Aktualisieren Sie /dimmerlink.json mit den neuen Adressen
  4. Tasmota neu starten

Schritt für Schritt: 3 Geräte einrichten

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)

Adresse eines Geräts vergessen?

berry
import DimmerLink
DimmerLink.scan()

Dies zeigt immer die tatsächlichen Adressen am Bus, unabhängig vom Inhalt der Konfigurationsdatei.

Geräteinformationen abrufen

Wenn der Treiber bereits geladen ist, können Sie eine laufende Instanz inspizieren:

berry
global._dimmerlink[0].info()

Ausgabe:

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)

Tasmota Web-Konfiguration

Der DimmerLink-Treiber verwendet die standardmäßige Tasmota-Weboberfläche. Es werden keine speziellen Konfigurationsseiten benötigt.

Konfigurationsdatei (dimmerlink.json) I2C-Adressen einrichten Tasmota Web-Konfiguration