← Integración con Tasmota | Contenido | Next: Build & Flash →
Descripción general del controlador nativo — DimmerLink Tasmota
Controlador: xdrv_94_dimmerlink.ino (XDRV_94 / XI2C_100)
Plataformas: ESP32, ESP8266
¿Qué es el controlador nativo?
El controlador C nativo de DimmerLink (xdrv_94_dimmerlink.ino) integra el controlador de atenuador AC MCU TRIAC en Tasmota como un controlador compilado. A diferencia del controlador con script Berry, el controlador nativo se compila directamente en el binario del firmware y no requiere carga de archivos ni configuración de autoexec.be. Se activa automáticamente al arrancar cuando se detecta un dispositivo DimmerLink compatible en el bus I2C.
Diferencias clave con el controlador Berry
| Aspecto | Controlador C nativo | Controlador Berry |
|---|---|---|
| Activación | Automática — compilado, detecta I2C al arrancar | Manual — archivos cargados, configurados en autoexec.be |
| Plataforma | ESP32 y ESP8266 | Solo ESP32 (Berry no disponible en ESP8266) |
| Configuración | user_config_override.h en tiempo de compilación |
/dimmerlink.json en tiempo de ejecución |
| Prefijo de comando | Dl (ej. DlDim, DlCurve) |
DimmerLink (ej. DimmerLink_Kitchen) |
| Instancias con nombre | No soportado — dispositivos indexados como Dev1, Dev2 | Soportado — cada dispositivo tiene una etiqueta |
| Auto-escaneo | Escaneo completo del bus I2C en todos los buses (0x08–0x77) | Configuración de dirección manual |
Características principales
- Hasta 4 dispositivos, cada uno con hasta 4 canales (16 canales en total)
- Controles deslizantes de brillo y visualización de sensores en la interfaz web
- Telemetría MQTT con datos JSON por canal
- HTTP API para control remoto mediante
curlo sistemas de automatización - Tres curvas de atenuación: LINEAR, RMS, LOG (por canal)
- Transiciones de fundido por hardware (0 a 25,5 segundos)
- Monitoreo de temperatura e informes de protección térmica
- Detección automática de frecuencia de CA (50/60 Hz)
Requisitos
| Categoría | Detalles |
|---|---|
| Herramienta de compilación | PlatformIO (CLI o extensión de VS Code) |
| MCU | ESP32 (cualquier variante) o ESP8266 |
| Hardware | Dispositivo DimmerLink con modo I2C habilitado |
| Cableado | SDA, SCL, GND, VCC con resistencias pull-up de 4,7 kOhm |
Archivos del controlador
| Archivo | Propósito |
|---|---|
xdrv_94_dimmerlink.ino |
Código fuente del controlador — colocar en el directorio tasmota/ |
user_config_override.h |
Habilitar la definición USE_DIMMERLINK |
Tip: Descargar el código fuente del controlador:
xdrv_94_dimmerlink.ino en GitHub
Documentación
| Página | Descripción |
|---|---|
| Build & Flash | Configuración de PlatformIO, compilación, flasheo mediante USB y OTA |
| Comandos | Referencia completa de comandos — DlDim, DlCurve, DlFade, DlStatus, DlReset, DlRecalibrate, DlAddress |
| Web, MQTT & HTTP | Controles deslizantes de la interfaz web, JSON de telemetría MQTT, endpoints de HTTP API |
| Funciones avanzadas | Curvas de atenuación explicadas, control de fundido, monitoreo de temperatura, configuración multidispositivo, migración desde Berry |
| Referencia | Solución de problemas, códigos de error, mapa de registros I2C, estados térmicos |