Integración comunitaria Tasmota, gratuita y de código abierto
Controle sus dispositivos Tasmota en local por MQTT o HTTP: relés, luces, energía, sensores.
Publicado por gboulvin
- Dispositivos
- Versión 1.0.2
- Requiere Gladys >=5.1.0
- ★ 0
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 0y 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ón | Rellenar | Necesita |
|---|---|---|
| Opción 1 — Mi broker MQTT existente | bloque 1 | la dirección y las credenciales |
| Opción 2 — Broker dedicado desplegado por Gladys | bloque 2 | nada (contraseña opcional) |
| Opción 3 — Sin MQTT, solo HTTP | bloque 3 | las 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).
- Modo de conexión: Opción 1 — Mi broker MQTT existente.
- Bloque 1 — URL del broker:
mqtt://<IP del broker>:1883— use la IP de la red local, nolocalhost(la integración funciona en su propio contenedor). - Bloque 1 — Usuario del broker y Contraseña del broker, y guarde.
- 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
- Modo de conexión: Opción 2 — Broker dedicado desplegado por la integración.
- 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). - 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 …. - 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
- Modo de conexión: Opción 3 — Sin MQTT, solo HTTP.
- Bloque 3 — Direcciones HTTP:
192.168.1.20, 192.168.1.30-45(o use la acción Escanear un rango de IP). - 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.
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):
| Disparador | Ajuste de Tasmota necesario | Variables |
|---|---|---|
| Botón Tasmota pulsado | SetOption73 1 (botones desacoplados de los relés) | button, action |
| Entrada de interruptor Tasmota cambiada | SetOption114 1 (interruptores desacoplados de los relés) | switch, action |
| Código RF recibido | un RF Bridge (RfReceived) | code, rf_key |
| Código IR recibido | un receptor IR (IrReceived) | code, protocol |
| Dispositivo Tasmota en línea / desconectado | ninguno (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 1al dispositivo (ySetOption114 1para las entradas de interruptor). - Registros: abra los registros de la integración desde Gladys;
LOG_LEVEL=debugda 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ámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Paso 1 — Elija cómo se conectan sus dispositivos | section | No | Opció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ón | select | Sí | |
| Bloque 1 — Mi broker MQTT existente (solo opción 1) | section | No | La 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 broker | string | No | |
| Usuario del broker | string | No | |
| Contraseña del broker | secret | No | |
| Bloque 2 — Broker dedicado de la integración (solo opción 2) | section | No | Nada 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 dispositivos | secret | No | Opcional: déjela vacía para generar una. |
| Topics MQTT (opciones 1 y 2) | section | No | Mantenga el valor predeterminado salvo que haya cambiado el Full Topic de sus dispositivos. |
| FullTopic de Tasmota | select | Sí | |
| Bloque 3 — Dispositivos HTTP (opción 3, opcional con las opciones 1 y 2) | section | No | Dispositivos 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 HTTP | string | No | IP, nombres de host o rangos, separados por comas. |
| Usuario web | string | No | |
| Contraseña web | secret | No | |
| Intervalo de actualización HTTP (s) | number | No | Frecuencia de lectura de los dispositivos HTTP (los MQTT envían sus cambios). |
Cómo instalar Tasmota en Gladys
- En Gladys, abre Integraciones: Tasmota aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/gboulvin/gladys-tasmota:1.0.2), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- 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.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación