Ir al contenido

← Integración ESPHome | Contenido | Siguiente: Descripción general de Lambda →

DimmerLink — Integración ESPHome Lambda

← Integración ESPHome


Integración del dimmer AC TRIAC DimmerLink con Home Assistant a través de ESPHome mediante funciones lambda.

Tip
Para un enfoque más sencillo sin código lambda, consulte el [componente externo](https://github.com/robotdyn-dimmer/DimmerLink/tree/main/components).



Contenido


Secciones principales

  1. Introducción — Descripción general, requisitos, conexión, configuración básica
  2. Entidades — Entidades listas para usar en su configuración
  3. Ejemplos — Configuraciones YAML completas y funcionales
  4. Referencia Lambda — Referencia de registros I2C y funciones lambda
  5. Solución de problemas — Integración con Home Assistant, solución de problemas, hoja de ruta



Inicio rápido


1. Conexión

text
ESP32          DimmerLink
─────          ──────────
3.3V     →     VCC
GND      →     GND
GPIO21   →     SDA
GPIO22   →     SCL


2. Configuración mínima

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. Flashear el firmware

bash
esphome run dimmerlink.yaml

30 líneas — ¡y el dimmer ya está en Home Assistant!




Tipos de entidades

Entidad Plataforma Descripción
Light monochromatic Dimmer principal con control de brillo
Sensor template Frecuencia AC, nivel, versión
Binary Sensor template Estado de disponibilidad, indicador de error
Text Sensor template Código de error (texto)
Select template Selección de curva de atenuación
Number template Control directo del nivel
Button template Reinicio, recalibración

Más información sobre las entidades




Ejemplos de configuración

Ejemplo Descripción Enlace
Mínimo Light + I2C básico
Estándar Light + sensores + Select
Extendido Todas las entidades + diagnósticos
Multi-dispositivo 2+ dimmers en un bus
Con botón Control mediante botón físico
Producción Para entorno de producción

Todos los ejemplos




Mapa de registros (resumen)

Dirección Nombre R/W Descripción
0x00 STATUS R Estado del dispositivo
0x01 COMMAND W Comandos de control
0x02 ERROR R Último código de error
0x10 DIM0_LEVEL R/W Brillo 0–100 %
0x11 DIM0_CURVE R/W Curva 0–2
0x20 AC_FREQ R Frecuencia AC
0x30 I2C_ADDRESS R/W Dirección I2C

Referencia completa




Documento Descripción
External Component Componente ESPHome DimmerLink (sin lambdas)
I2C Communication Detalles del protocolo I2C
Hardware Connection Diagramas de cableado



Historial de versiones

Versión Fecha Cambios
1.0 2026-02 Lanzamiento inicial

← Integración ESPHome

← Integración ESPHome | Contenido | Siguiente: Descripción general de Lambda →