← Integración ESPHome | Contenido | Siguiente: Descripción general de Lambda →
DimmerLink — Integración ESPHome Lambda
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
- Introducción — Descripción general, requisitos, conexión, configuración básica
- Entidades — Entidades listas para usar en su configuración
- Ejemplos — Configuraciones YAML completas y funcionales
- Referencia Lambda — Referencia de registros I2C y funciones lambda
- 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 | → |
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 |
Documentación relacionada
| 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 | Contenido | Siguiente: Descripción general de Lambda →