Saltar al contenido principal

Integración comunitaria Tasmota, gratuita y de código abierto

Integración Tasmota para Gladys Assistant

Controle sus dispositivos Tasmota en local por MQTT o HTTP: relés, luces, energía, sensores.

Ver en GitHubTodas las integraciones

Controle sus dispositivos Tasmota desde Gladys, 100 % en local: enchufes, relés, bombillas y tiras LED, reguladores, persianas, ventiladores, medidores de energía y sensores. Sin nube.

Qué obtiene​

  • Descubrimiento automático por MQTT (LWT, Status 0 y el descubrimiento nativo de Tasmota) y por HTTP (una lista de direcciones o el escaneo de un rango de IP).
  • Cada dispositivo se identifica por su dirección MAC: renombrarlo, cambiar su topic o su IP, o pasarlo de HTTP a MQTT conserva el mismo dispositivo Gladys y su historial.
  • Relés (POWER1…POWER8), luces (encendido/apagado, brillo, color RGB, temperatura de blanco, efectos y su velocidad), ventiladores (FanSpeed), persianas (abrir / cerrar / parar, posición).
  • Medición de energía: potencia, potencias aparente y reactiva, tensión, corriente, energía de hoy, de ayer y total (el total es un índice acumulado, utilizable por el seguimiento de energía de Gladys), medidores multicanal incluidos.
  • Sensores: temperatura, humedad, presión, iluminancia, CO2, COV, PM2.5 / PM10, distancia, índice UV, humedad del suelo, entradas analógicas, contadores de impulsos, entradas de interruptor, temperatura del chip, señal Wi-Fi y tiempo activo.
  • Disparadores de escena: botón pulsado (simple, doble, triple… mantenido), entrada de interruptor cambiada, código RF recibido (Sonoff RF Bridge), código IR recibido, dispositivo en línea / desconectado.
  • Acciones de escena: enviar cualquier comando Tasmota (Backlog, RfSend, IRSend, Rule…), encender un relé un tiempo, hacer parpadear una luz, reiniciar un dispositivo.
  • Widgets del panel: vista general, ficha de dispositivo, ficha de energía.
  • Una insignia «Local» en cada dispositivo, naranja cuando el broker no responde y los comandos pasan por HTTP, roja cuando el dispositivo es inaccesible.

Elegir cómo hablan los dispositivos con Gladys​

La pantalla de configuración empieza por Paso 1 — Modo de conexión, seguido de tres bloques. Gladys muestra todos los bloques a la vez: rellene solo el bloque de la opción elegida, los demás se ignoran y pueden quedar vacíos. El estado en la parte superior de la pantalla indica siempre la opción activa y lo que falta.

Modo de conexiónRellenarNecesita
Opción 1 — Mi broker MQTT existentebloque 1la dirección y las credenciales
Opción 2 — Broker dedicado desplegado por Gladysbloque 2nada (contraseña opcional)
Opción 3 — Sin MQTT, solo HTTPbloque 3las direcciones IP de los equipos

Opción 1 — Mi broker MQTT existente​

Por ejemplo el broker de la integración MQTT de Gladys, que ya funciona en el equipo de Gladys (puerto 1883, con el usuario y la contraseña que muestra la página de esa integración).

  1. Modo de conexión: Opción 1 — Mi broker MQTT existente.
  2. Bloque 1 — URL del broker: mqtt://<IP del broker>:1883 — use la IP de la red local, no localhost (la integración funciona en su propio contenedor).
  3. Bloque 1 — Usuario del broker y Contraseña del broker, y guarde.
  4. En cada dispositivo Tasmota: Configuration → MQTT, introduzca el mismo host, puerto, usuario y contraseña.

Opción 2 — Broker dedicado desplegado por la integración​

  1. Modo de conexión: Opción 2 — Broker dedicado desplegado por la integración.
  2. Bloque 2 — Contraseña de los dispositivos: opcional, déjela vacía para generar una. Guarde: la integración inicia su propio contenedor Mosquitto; el bloque 2 muestra la dirección y el puerto que deben usar los dispositivos (usuario tasmota).
  3. Ejecute la acción Opción 2 — Obtener el comando para los dispositivos (escriba la IP de Gladys): da una línea lista para pegar, por ejemplo Backlog MqttHost 192.168.1.10; MqttPort 41883; MqttUser tasmota; MqttPassword ….
  4. Péguela en la Console de cada dispositivo Tasmota. El dispositivo se reinicia y aparece en Gladys.

Topics MQTT (opciones 1 y 2)​

Conserve %prefix%/%topic%/, el valor predeterminado de Tasmota, salvo que haya cambiado el Full Topic de sus dispositivos a %topic%/%prefix%/.

Opción 3 — Sin MQTT, solo HTTP​

  1. Modo de conexión: Opción 3 — Sin MQTT, solo HTTP.
  2. Bloque 3 — Direcciones HTTP: 192.168.1.20, 192.168.1.30-45 (o use la acción Escanear un rango de IP).
  3. Usuario web (admin) y Contraseña web: solo si hay una contraseña web en los dispositivos. Los dispositivos se leen cada Intervalo de actualización HTTP segundos (30 por defecto).

El bloque 3 también funciona con las opciones 1 y 2, para los pocos dispositivos que no usan MQTT. Un dispositivo encontrado por HTTP que luego se conecta al broker pasa a MQTT por sí solo; la acción Pasar un dispositivo a MQTT le envía los ajustes del broker por usted.

Añadir los dispositivos​

Abra la pestaña Descubrimiento de la integración: allí aparecen los dispositivos encontrados, con sus funciones. Pulse Añadir, elija la habitación y listo. Cuando un dispositivo gana una función (un sensor conectado, un nuevo firmware), aparece un botón Actualizar.

Migrar desde la integración Tasmota nativa​

¿Usaba la integración Tasmota incluida en Gladys? Gladys puede pasar cada dispositivo a esta integración con un clic, conservando el historial de sus estados, las escenas y paneles que lo usan, su habitación y los ajustes de termostato que apuntan a él. Después se elimina el dispositivo antiguo.

Hace falta una versión de Gladys que muestre un botón Migrar en los dispositivos de la integración Tasmota nativa (GladysAssistant/Gladys#3256). Mientras tanto, las dos integraciones pueden funcionar en paralelo.

  1. Conecte esta integración al mismo broker que la nativa: opción 1, con en el bloque 1 la dirección y las credenciales del broker de la integración MQTT de Gladys. Las dos integraciones pueden escuchar los mismos dispositivos a la vez, no cambia nada en los dispositivos. Dispositivos HTTP: indique sus direcciones en el bloque 3.

  2. En la pestaña Descubrimiento, añada el dispositivo y conserve por ahora el nativo.

  3. Migre enseguida. Cuando los dos dispositivos registran estados en paralelo, Gladys solo conserva el historial antiguo hasta el primer estado del nuevo dispositivo: los estados registrados por duplicado entre tanto se eliminan. Cuanto más espere, más largo es ese periodo.

  4. Abra la integración Tasmota nativa, pestaña Dispositivos, y pulse Migrar en el dispositivo. Elija su nueva versión: la lista agrupa los dispositivos por integración e indica su habitación.

  5. Compruebe la asociación de las funciones y confirme. La mayoría se asocian automáticamente (relés, luces, potencia, tensión, corriente, energía del día, temperatura, humedad…). Dos casos se asocian a mano:

    • Energía total: asóciela a Energy total. Gladys avisa de que los tipos difieren (energy en la integración nativa, index aquí, el tipo en el que se basa el seguimiento de energía); los valores en kWh son los mismos, puede confirmar.
    • Una luz vista como interruptor: la integración nativa solo reconoce algunos módulos de luz, los demás llegaban como interruptor. Esta integración reconoce la luz: asocie Switch con Light.

    Una función sin asociar pierde su historial, y las escenas que la usan deben modificarse.

  6. Con un historial grande, la migración tarda unos minutos: sígala en Configuración → Tareas. Si se interrumpe, vuelva a lanzarla: solo mueve lo que queda.

Una vez migrados todos los dispositivos, la integración Tasmota nativa ya no tiene ningún dispositivo.

Acciones de la pantalla de configuración​

  • Probar la conexión — estado del broker y número de dispositivos en línea.
  • Opción 2 — Obtener el comando para los dispositivos — la línea de consola para el broker dedicado.
  • Añadir un dispositivo HTTP / Escanear un rango de IP — encontrar dispositivos por HTTP (1024 direcciones como máximo).
  • Identificar una luz — la luz parpadea dos veces y vuelve a su estado. Los relés nunca parpadean (pueden controlar un radiador).
  • Enviar un comando — cualquier comando Tasmota, la respuesta aparece bajo el botón.
  • Reiniciar un dispositivo.
  • Pasar un dispositivo a MQTT — envía MqttHost, MqttPort, MqttUser, MqttPassword.

Escenas​

En la categoría Integraciones del editor de escenas (Gladys 5.1 o posterior):

DisparadorAjuste de Tasmota necesarioVariables
Botón Tasmota pulsadoSetOption73 1 (botones desacoplados de los relés)button, action
Entrada de interruptor Tasmota cambiadaSetOption114 1 (interruptores desacoplados de los relés)switch, action
Código RF recibidoun RF Bridge (RfReceived)code, rf_key
Código IR recibidoun receptor IR (IrReceived)code, protocol
Dispositivo Tasmota en línea / desconectadoninguno (LWT por MQTT, lecturas fallidas por HTTP)status

Cada filtro es opcional: vacío, acepta todo. Lea los valores en las acciones siguientes con {{triggerEvent.data.code}}, por ejemplo.

Acciones: Enviar un comando Tasmota (salidas answered y response), Encender un relé un tiempo (el dispositivo lo apaga por sí mismo, hasta 360 s), Hacer parpadear una luz Tasmota, Reiniciar un dispositivo Tasmota.

Los estados en sí (un relé, una temperatura…) son funciones de dispositivo normales: use para ellos el disparador «Estado de un dispositivo» y la acción «Controlar un dispositivo» de Gladys.

Panel​

  • Dispositivos Tasmota — número de dispositivos, en línea y desconectados, conexión al broker, estado de cada dispositivo, un botón Actualizar.
  • Dispositivo Tasmota — elija un dispositivo: sus principales valores en directo, IP, firmware, señal Wi-Fi, tiempo activo y los botones Alternar, Identificar (luces) y Reiniciar.
  • Energía Tasmota — elija un medidor: curva de potencia de 24 horas, potencia, tensión y corriente en directo, energía de hoy, de ayer y total.

Solución de problemas​

  • Nada en Descubrimiento (MQTT): compruebe que la URL del broker usa la IP de la red local y que los dispositivos muestran «MQTT connected» en su consola. Pulse Escanear en la pestaña Descubrimiento: se vuelve a consultar cada dispositivo conocido.
  • Un dispositivo pide contraseña (HTTP): indique el usuario y la contraseña web en la configuración, o en los campos de las acciones Añadir / Escanear.
  • Los botones no disparan escenas: envíe SetOption73 1 al dispositivo (y SetOption114 1 para las entradas de interruptor).
  • Registros: abra los registros de la integración desde Gladys; LOG_LEVEL=debug da todo el detalle.

Parámetros de configuración​

Estos son los parámetros que Tasmota te pide en su pantalla de configuración en Gladys.

ParámetroTipoObligatorioDescripción
Paso 1 — Elija cómo se conectan sus dispositivossectionNoOpción 1: ya tiene un broker MQTT (por ejemplo el de la integración MQTT de Gladys): rellene el bloque 1 con su dirección y credenciales. Opción 2: no tiene broker: la integración despliega un contenedor Mosquitto dedicado, rellene solo el bloque 2. Opción 3: sin MQTT, los dispositivos se leen por HTTP: rellene solo el bloque 3. Los bloques de las otras opciones se ignoran, puede dejarlos vacíos.
Modo de conexiónselectSí
Bloque 1 — Mi broker MQTT existente (solo opción 1)sectionNoLa dirección y las credenciales de su broker. Con el broker de la integración MQTT de Gladys: mqtt://<IP de Gladys>:1883 y el usuario y la contraseña que muestra la página de esa integración. Use la IP de la red local, no localhost: la integración funciona en su propio contenedor. Sus dispositivos Tasmota deben apuntar al mismo broker (Configuration > MQTT en cada dispositivo).
URL del brokerstringNo
Usuario del brokerstringNo
Contraseña del brokersecretNo
Bloque 2 — Broker dedicado de la integración (solo opción 2)sectionNoNada que instalar: al guardar, la integración inicia su propio contenedor Mosquitto. Sus dispositivos se conectan a {{gladys_host}}, puerto {{port:mqtt}}, usuario tasmota, con la contraseña de abajo (déjela vacía para generar una). Después ejecute la acción «Obtener el comando para los dispositivos»: da la línea que pegar en la consola de cada dispositivo Tasmota.
Contraseña de los dispositivossecretNoOpcional: déjela vacía para generar una.
Topics MQTT (opciones 1 y 2)sectionNoMantenga el valor predeterminado salvo que haya cambiado el Full Topic de sus dispositivos.
FullTopic de TasmotaselectSí
Bloque 3 — Dispositivos HTTP (opción 3, opcional con las opciones 1 y 2)sectionNoDispositivos leídos por HTTP, cada pocos segundos. Obligatorio con la opción 3; con las opciones 1 y 2, solo para los dispositivos que no usan MQTT. Indique sus direcciones (o use la acción «Escanear un rango de IP»). Usuario y contraseña web: solo si hay una contraseña web en los dispositivos.
Direcciones HTTPstringNoIP, nombres de host o rangos, separados por comas.
Usuario webstringNo
Contraseña websecretNo
Intervalo de actualización HTTP (s)numberNoFrecuencia de lectura de los dispositivos HTTP (los MQTT envían sus cambios).

Cómo instalar Tasmota en Gladys​

  1. En Gladys, abre Integraciones: Tasmota aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
  2. Haz clic en Instalar. Gladys descarga la imagen Docker (ghcr.io/gboulvin/gladys-tasmota:1.0.3), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración).
  3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
  4. También puedes instalarla directamente desde la URL de su repositorio: https://github.com/gboulvin/Gladys-Tasmota.

Tasmota requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.

¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.

Sobre las integraciones externas​

Tasmota es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene gboulvin, no el equipo principal de Gladys.

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂
Última actualización en