Passa al contenuto

← Integrazione ESPHome | Indice | Avanti: Panoramica Lambda →

DimmerLink — Integrazione ESPHome Lambda

← Integrazione ESPHome


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

  1. Introduzione — Panoramica, requisiti, collegamento, configurazione di base
  2. Entità — Entità pronte all'uso per la propria configurazione
  3. Esempi — Configurazioni YAML complete e funzionanti
  4. Riferimento Lambda — Riferimento ai registri I2C e alle funzioni lambda
  5. 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

Tutti gli esempi




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

Riferimento completo




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

← Integrazione ESPHome | Indice | Avanti: Panoramica Lambda →