El plugin MQTT permite la comunicación con un broker (servidor) MQTT en la red. El Miniserver siempre actúa como un cliente MQTT y soporta el envío ("publicación") de datos y la recepción ("suscripción") de datos desde el broker.
MQTT (Message Queuing Telemetry Transport) es un protocolo simple y ligero que puede ser utilizado para la comunicación entre dispositivos. Es ampliamente utilizado para aplicaciones de "Internet de las Cosas (IoT)", por ejemplo, para recopilar datos de sensores o controlar dispositivos inteligentes.
Se requiere un broker MQTT al cual el Miniserver puede suscribirse y publicar. El Miniserver puede gestionar 16 suscripciones (entradas) así como 16 publicaciones (salidas).
Tenga en cuenta que el Miniserver Gen. 1 no es compatible. |
Contenido
Creación y configuración de un objeto↑
El complemento MQTT está integrado a través de la Periferia de Red:
Un complemento MQTT solo puede conectarse a un broker a la vez. Configure los ajustes de la siguiente manera:
Envío/Recepción de Datos↑
Para recibir datos del broker (suscribirse) o enviar datos al broker (publicar), cree el objeto apropiado:
El envío y la recepción de mensajes se basan siempre en temas, que sirven como ruta o dirección que identifica los datos. Las suscripciones pueden escuchar varios temas simultáneamente utilizando (comodines). Las publicaciones no admiten comodines.
Ejemplo de tema:
Si es necesario enviar datos a un sensor de temperatura del salón, el tema correspondiente podría tener este aspecto:
home/livingroom/temperature
Suscripción:
Suscribirse (recibir):
Recibe valores sobre el tema especificado desde el corredor.
Otro dispositivo o aplicación puede suscribirse a este tema para recibir los mensajes transmitidos. Por ejemplo, un termostato podría suscribirse al tema home/livingroom/temperature para obtener los datos de temperatura.
Si se reciben datos en formato JSON o similar, se recomienda utilizar el bloque "Reconocimiento de Comandos" para extraer el valor analógico de los datos.
Los cambios en el valor de la suscripción se evalúan como máximo una vez cada 2 segundos. Si un cambio de valor ocurre dentro de los 2 segundos siguientes al anterior, el nuevo cambio se almacenará en caché. Después del intervalo de 2 segundos, se procesará el cambio más reciente. Este enfoque ayuda a reducir la carga en el Miniserver, especialmente cuando se envían múltiples cambios a un tema en un corto período de tiempo. |
Comodines en Suscripciones:
Para evitar tener que suscribirse a cada tema individualmente, MQTT soporta comodines, los cuales permiten suscribirse a múltiples temas simultáneamente:
Comodín de un solo nivel (+): Reemplaza exactamente un nivel de tema en la ruta del tema.
Ejemplo:
chome/+/temperature
Esta suscripción recibe mensajes de todas las habitaciones de la casa que envían datos de temperatura, tales como:
home/livingroom/temperature
home/kitchen/temperature
Comodín de múltiples niveles (#): Cubre todos los niveles de tema subsiguientes en la ruta del tema y debe usarse al final de la ruta.
Ejemplo:
home/#
Esta suscripción recibe todos los mensajes que comienzan con home/, sin importar el número de niveles subsecuentes, tales como:
home/livingroom/temperature
home/kitchen/humidity
home/garage/car/battery
Solo las suscripciones admiten comodines, las publicaciones no. Un dispositivo solo puede enviar mensajes a un tema específico, no a múltiples temas simultáneamente. |
Publicar:
Publicar (enviar):
Un dispositivo (cliente) envía un mensaje a un tema específico. En el ejemplo anterior, el sensor de temperatura enviaría la temperatura actual a home/livingroom/temperature.
Sensores↑
Resumen | Unidad |
---|---|
Subscription | Texto |
Actuadores↑
Resumen | Unidad |
---|---|
Publish | Texto |
Entradas de diagnóstico↑
Resumen | Descripción | Unidad | Rango de valores |
---|---|---|---|
Onlinestatus | Indica si el Miniserver puede acceder al dispositivo. Diagnóstico para dispositivos Air Diagnóstico para dispositivos Tree Diagnóstico de Extension |
Digital | 0/1 |
Propiedades↑
Resumen | Descripción | Rango de valores | Valor por defecto |
---|---|---|---|
Dirección del Broker | Dirección de red del broker MQTT | - | - |
Puerto del Broker | Puerto de red del broker MQTT (Predeterminado: 1883) | 0...65535 | - |
Versión del protocolo | Versión del protocolo MQTT compatible con el broker MQTT (por defecto: MQTTv5) | - | - |
ID del cliente | El ID de este cliente MQTT. ¡El ID debe ser único al conectarse al broker MQTT! Al usar el protocolo MQTTv3, el ID se trunca a 23 caracteres. | - | - |
Usuario | Nombre de usuario para la autenticación en el broker MQTT. Dejar en blanco para inicio de sesión anónimo (si el broker MQTT lo permite). | - | - |
Contraseña | Contraseña para la autenticación en el broker MQTT. Dejar en blanco para inicio de sesión anónimo (si el broker MQTT lo permite). | - | - |
Utilice SSL/TLS | Utiliza una conexión SSL/TLS con el broker MQTT. | - | - |
Supervisar el servicio | Si está marcada, se notificará mediante el Estado del Sistema o por correo electrónico si este servicio no está disponible o desconectado. | - | - |