← Integrazione ESPHome | Indice | Avanti: Panoramica Lambda →
DimmerLink — Integrazione ESPHome Lambda
Integrazione del dimmer AC TRIAC DimmerLink con Home Assistant tramite ESPHome usando funzioni lambda.
Tip
Per un approccio più semplice senza codice lambda, consultare il [componente esterno](https://github.com/robotdyn-dimmer/DimmerLink/tree/main/components).
Indice
Sezioni principali
- Introduzione — Panoramica, requisiti, collegamento, configurazione di base
- Entità — Entità pronte all'uso per la propria configurazione
- Esempi — Configurazioni YAML complete e funzionanti
- Riferimento Lambda — Riferimento ai registri I2C e alle funzioni lambda
- Risoluzione dei problemi — Integrazione con Home Assistant, risoluzione dei problemi, roadmap
Avvio rapido
1. Collegamento
text
ESP32 DimmerLink
───── ──────────
3.3V → VCC
GND → GND
GPIO21 → SDA
GPIO22 → SCL
2. Configurazione minima
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. Flash del firmware
bash
esphome run dimmerlink.yaml
30 righe — e il dimmer è già in Home Assistant!
Tipi di entità
| Entità | Piattaforma | Descrizione |
|---|---|---|
| Light | monochromatic |
Dimmer principale con regolazione della luminosità |
| Sensor | template |
Frequenza AC, livello, versione |
| Binary Sensor | template |
Stato di disponibilità, flag di errore |
| Text Sensor | template |
Codice di errore (testo) |
| Select | template |
Selezione della curva di dimmerizzazione |
| Number | template |
Controllo diretto del livello |
| Button | template |
Reset, ricalibrazione |
→ Ulteriori informazioni sulle entità
Esempi di configurazione
| Esempio | Descrizione | Link |
|---|---|---|
| Minimo | Light + I2C di base | → |
| Standard | Light + sensori + Select | → |
| Esteso | Tutte le entità + diagnostica | → |
| Multi-dispositivo | 2+ dimmer su un bus | → |
| Con pulsante | Controllo tramite pulsante fisico | → |
| Produzione | Per ambiente di produzione | → |
Mappa dei registri (sintesi)
| Indirizzo | Nome | R/W | Descrizione |
|---|---|---|---|
0x00 |
STATUS | R | Stato del dispositivo |
0x01 |
COMMAND | W | Comandi di controllo |
0x02 |
ERROR | R | Ultimo codice di errore |
0x10 |
DIM0_LEVEL | R/W | Luminosità 0–100 % |
0x11 |
DIM0_CURVE | R/W | Curva 0–2 |
0x20 |
AC_FREQ | R | Frequenza AC |
0x30 |
I2C_ADDRESS | R/W | Indirizzo I2C |
Documentazione correlata
| Documento | Descrizione |
|---|---|
| External Component | Componente ESPHome DimmerLink (senza lambda) |
| I2C Communication | Dettagli del protocollo I2C |
| Hardware Connection | Schemi di cablaggio |
Cronologia delle versioni
| Versione | Data | Modifiche |
|---|---|---|
| 1.0 | 2026-02 | Prima pubblicazione |
← Integrazione ESPHome | Indice | Avanti: Panoramica Lambda →