Saltar al contenido principal

MQTT

El protocolo MQTT (Message Queuing Telemetry Transport) en InDataX permite integrar dispositivos IoT y sistemas de telemetría mediante un modelo de publicación/suscripción. InDataX actúa como cliente, conectándose a un broker y suscribiéndose a tópicos específicos para recibir datos en formato JSON.

Broker MQTT​

InDataX incorpora su propio broker MQTT interno que funciona de manera predeterminada sin necesidad de configuraciones adicionales.

Si prefieres utilizar un broker externo, debes modificar los siguientes parámetros en el archivo .env ubicado en la carpeta de instalación:

  • MQTT_HOSTNAME: Dirección o IP del broker externo.
  • MQTT_PORT: Puerto de conexión del broker.
  • MQTT_USER: Nombre de usuario con el que InDataX se identificará ante el broker.
  • Contraseña: El broker externo deberá estar configurado para aceptar como contraseña el contenido del parámetro SECRET definido en el mismo archivo .env.

Parámetros de Conexión​

Para configurar un nuevo canal MQTT, define los siguientes campos:

  • Nombre: Identificador único del protocolo.
  • Tópico MQTT: La ruta del tópico al que InDataX se suscribirá (p.ej., sensores/planta1/temperatura).

Configuración de Variables​

En MQTT, la extracción de datos se realiza mediante el mapeo de claves JSON. El sistema espera recibir un mensaje cuyo "payload" sea un objeto JSON válido.

  • Nombre: Nombre de la variable en InDataX.
  • Tipo: Tipo de dato (Real, Entero, Booleano, etc.).
  • Audit trail: Registro de auditoría para cambios de valor.
  • Registrar valor: Inclusión en los históricos de la Thing.
  • Clave: Es el nombre de la propiedad dentro del objeto JSON que contiene el valor deseado.

Ejemplo​

Si el sistema recibe el siguiente mensaje en el tópico configurado:

{
  "temp": 25.5,
  "hum": 60,
  "status": "OK"
}

Para leer la temperatura, configuraríamos una variable con la Clave: temp. InDataX extraerá automáticamente el valor 25.5.