← ESPHome Integration | Inhaltsverzeichnis | Weiter: Lambda-Übersicht →
DimmerLink — ESPHome Lambda-Integration
Integration des DimmerLink AC TRIAC-Dimmers mit Home Assistant über ESPHome mittels Lambda-Funktionen.
Tip
Für einen einfacheren Ansatz ohne Lambda-Code siehe die [External Component](https://github.com/robotdyn-dimmer/DimmerLink/tree/main/components).
Inhaltsverzeichnis
Hauptabschnitte
- Einführung — Übersicht, Anforderungen, Anschluss, Grundkonfiguration
- Entitäten — Einsatzbereite Entitäten für Ihre Konfiguration
- Beispiele — Vollständige, funktionsfähige YAML-Konfigurationen
- Lambda-Referenz — Referenz zu I2C-Registern und Lambda-Funktionen
- Fehlerbehebung — Home Assistant-Integration, Fehlerbehebung, Roadmap
Schnellstart
1. Anschluss
text
ESP32 DimmerLink
───── ──────────
3.3V → VCC
GND → GND
GPIO21 → SDA
GPIO22 → SCL
2. Minimale Konfiguration
yaml
esphome:
name: dimmerlink
esp32:
board: esp32dev
logger:
api:
ota:
wifi:
ssid: "YOUR_WIFI"
password: "YOUR_PASSWORD"
i2c:
sda: GPIO21
scl: GPIO22
id: bus_a
output:
- platform: template
id: dimmer_out
type: float
write_action:
- lambda: |-
uint8_t level = (uint8_t)(state * 100.0f);
uint8_t data[2] = {0x10, level};
id(bus_a).write(0x50, data, 2, true);
light:
- platform: monochromatic
name: "Dimmer"
output: dimmer_out
gamma_correct: 1.0
3. Firmware flashen
bash
esphome run dimmerlink.yaml
30 Zeilen — und der Dimmer ist in Home Assistant!
Entitätstypen
| Entität | Plattform | Beschreibung |
|---|---|---|
| Light | monochromatic |
Haupt-Dimmer mit Helligkeitsregelung |
| Sensor | template |
AC-Frequenz, Pegel, Version |
| Binary Sensor | template |
Bereitstatus, Fehler-Flag |
| Text Sensor | template |
Fehlercode (Text) |
| Select | template |
Auswahl der Dimmkurve |
| Number | template |
Direkte Pegelsteuerung |
| Button | template |
Zurücksetzen, Neukalibrierung |
Konfigurationsbeispiele
| Beispiel | Beschreibung | Link |
|---|---|---|
| Minimal | Light + einfaches I2C | → |
| Standard | Light + Sensoren + Select | → |
| Erweitert | Alle Entitäten + Diagnose | → |
| Multi-Gerät | 2+ Dimmer an einem Bus | → |
| Mit Taster | Steuerung per physischem Taster | → |
| Produktion | Für Produktionsumgebung | → |
Registerkarte (Kurzübersicht)
| Adresse | Name | R/W | Beschreibung |
|---|---|---|---|
0x00 |
STATUS | R | Gerätestatus |
0x01 |
COMMAND | W | Steuerbefehle |
0x02 |
ERROR | R | Letzter Fehlercode |
0x10 |
DIM0_LEVEL | R/W | Helligkeit 0–100 % |
0x11 |
DIM0_CURVE | R/W | Kurve 0–2 |
0x20 |
AC_FREQ | R | AC-Frequenz |
0x30 |
I2C_ADDRESS | R/W | I2C-Adresse |
Verwandte Dokumentation
| Dokument | Beschreibung |
|---|---|
| External Component | ESPHome DimmerLink-Komponente (ohne Lambdas) |
| I2C Communication | Details zum I2C-Protokoll |
| Hardware Connection | Anschlussdiagramme |
Versionshistorie
| Version | Datum | Änderungen |
|---|---|---|
| 1.0 | 2026-02 | Erstveröffentlichung |
← ESPHome Integration | Inhaltsverzeichnis | Weiter: Lambda-Übersicht →