Ir al contenido

← Primeros pasos | Contenido | Siguiente: Métodos de control →

Configuración

Archivo de configuración (dimmerlink.json)

El archivo de configuración se almacena en el sistema de archivos del ESP32 en /dimmerlink.json. Puede editarlo mediante Consoles > Manage File System > Edit.

Configuración mínima (un solo dispositivo, 1 canal)

json
{
  "devices": [
    {"addr": "0x50", "label": "Dimmer", "channels": 1}
  ],
  "presets": {
    "night": 10,
    "low": 25,
    "mid": 50,
    "high": 75,
    "full": 100
  }
}

Configuración multicanal (1 dispositivo, 2 canales)

json
{
  "devices": [
    {"addr": "0x50", "label": "Lamp", "channels": 2}
  ],
  "presets": {
    "night": 10,
    "full": 100
  }
}

Esto crea dos controles deslizantes: Lamp Ch1 y Lamp Ch2, controlados por los comandos DimmerLink_Lamp1 y DimmerLink_Lamp2.

Múltiples dispositivos en el mismo bus I2C

json
{
  "devices": [
    {"addr": "0x50", "label": "Kitchen", "channels": 1},
    {"addr": "0x51", "label": "Bedroom", "channels": 1},
    {"addr": "0x52", "label": "Hall", "channels": 2}
  ],
  "presets": {
    "night": 10,
    "evening": 40,
    "full": 100
  }
}

Cada dispositivo obtiene su propio control deslizante, comandos y entrada de telemetría.

Parámetros de configuración

Parámetro Tipo Requerido Predeterminado Descripción
addr string Sí "0x50" Dirección I2C en formato hexadecimal
label string Sí "DimmerLink" Nombre del dispositivo (usado en comandos e interfaz web)
channels integer No 1 Número de canales del atenuador (1–4)
presets object No (ver arriba) Niveles de brillo con nombre

Reglas de nomenclatura de etiquetas

Las etiquetas se utilizan en los nombres de comandos de Tasmota. Debido a cómo Tasmota analiza los comandos:

Etiqueta ¿OK? Por qué
Kitchen Sí Sin dígito final
DimmerA Sí Termina con letra
Dimmer1 No Tasmota lee «1» como índice de comando, no como parte del nombre
Room2 No Mismo problema — «2» se convierte en el índice
Lamp_North Sí El guion bajo y la letra son válidos

Si usa una etiqueta que termina con un dígito, el controlador mostrará una advertencia al inicio:

plaintext
DimmerLink WARNING: label 'Room2' ends with digit — commands will not work. Rename it.

Configuración de direcciones I2C

Cada dispositivo DimmerLink se entrega con la dirección I2C predeterminada 0x50. Para usar múltiples dispositivos en el mismo bus, cada uno debe tener una dirección única.

Verificar qué hay en el bus

Abra Consoles > Berry Scripting Console y ejecute:

berry
import DimmerLink
DimmerLink.scan()

Salida:

plaintext
I2C bus 0:
  0x50 - DimmerLink v1 (READY, 50Hz, level=0%)
Found 1 DimmerLink device(s)

Cambiar la dirección de un dispositivo

  1. Conecte el dispositivo que desea reconfigurar
  2. En la consola Berry, ejecute:
berry
import DimmerLink
DimmerLink.change_addr(0x50, 0x51)

Salida:

plaintext
DimmerLink at 0x50: v1, READY
Writing new address 0x51... OK
Verifying 0x51... OK
Address changed: 0x50 -> 0x51
>>> Update dimmerlink.json: change addr to 0x51
  1. El cambio de dirección es inmediato y se guarda en la memoria flash interna del dispositivo
  2. Desconecte la alimentación, conecte el siguiente dispositivo, enciéndalo, repita si es necesario
  3. Actualice /dimmerlink.json con las nuevas direcciones
  4. Reinicie Tasmota

Paso a paso: configurar 3 dispositivos

plaintext
1. Connect Device A only → it responds at 0x50 (default)
   Berry console: DimmerLink.change_addr(0x50, 0x51)
   → Device A is now at 0x51
2. Power off. Connect Device B only → it responds at 0x50
   Berry console: DimmerLink.change_addr(0x50, 0x52)
   → Device B is now at 0x52
3. Power off. Connect Device C (keep at default 0x50)
4. Power off. Connect all three devices together.
5. Edit dimmerlink.json:
   {
     "devices": [
       {"addr": "0x50", "label": "DeviceC", "channels": 1},
       {"addr": "0x51", "label": "DeviceA", "channels": 1},
       {"addr": "0x52", "label": "DeviceB", "channels": 1}
     ]
   }
6. Restart Tasmota.
7. Verify: DimmerLink.scan()
   0x50 - DimmerLink v1 (READY, 50Hz)
   0x51 - DimmerLink v1 (READY, 50Hz)
   0x52 - DimmerLink v1 (READY, 50Hz)
   Found 3 DimmerLink device(s)

¿Olvidó qué dirección usa un dispositivo?

berry
import DimmerLink
DimmerLink.scan()

Esto siempre muestra las direcciones reales en el bus, independientemente del contenido del archivo de configuración.

Obtener información del dispositivo

Si el controlador ya está cargado, puede inspeccionar una instancia en ejecución:

berry
global._dimmerlink[0].info()

Salida:

plaintext
DimmerLink "Kitchen" at 0x50 (bus 0)
  Channels:  1
  Levels:    Ch1=50%
  Power:     ON (relay 6)
  Curve:     Ch1=LINEAR
  Fade:      0 (0.0s)
  AC freq:   50 Hz
  Firmware:  v1
  Ready:     Yes
  preinit:   DimmerLink(0x50, "Kitchen", 1)

Configuración web de Tasmota

El controlador DimmerLink utiliza la interfaz web estándar de Tasmota. No se necesitan páginas de configuración especiales.

Archivo de configuración (dimmerlink.json) Configuración de direcciones I2C Configuración web de Tasmota