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.


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 →