Configuración de Comunicación MQTT

Esta guía le muestra cómo configurar la comunicación MQTT entre su cámara OV80i y dispositivos externos utilizando Node-RED. MQTT permite mensajería ligera y confiable para aplicaciones IoT y comunicación remota de dispositivos.

Cuándo usar la comunicación MQTT: Integración de dispositivos IoT, sistemas de monitoreo remoto, patrones de mensajería de publicación/suscripción, entornos de bajo ancho de banda, redes de sensores distribuidos, o cuando necesita entrega confiable de mensajes con reconexión automática.

Prerrequisitos

• Sistema de cámara OV80i configurado y conectado
• Conectividad de red entre la cámara y el broker MQTT
• Broker MQTT disponible (local o basado en la nube)
• Comprensión básica de los conceptos de MQTT (temas, publicación/suscripción)
• Receta activa configurada en la cámara

Visión general de la comunicación MQTT

Conceptos clave de MQTT:

• Broker: Servidor central que enruta mensajes entre clientes
• Temas: Categorías de mensajes (por ejemplo, "camera/status", "commands/trigger")
• Publicar: Enviar mensajes a un tema
• Suscribirse: Recibir mensajes de un tema
• QoS: Niveles de Calidad de Servicio (0, 1, 2)

Paso 1: Verificar la configuración de red

1.1 Verificar la configuración de red de la cámara

1. Navegue a Configuración del Sistema
2. Anote la dirección IP de la cámara (por ejemplo, 10.250.0.100)
3. Verifique la conectividad de red al broker MQTT

1.2 Requisitos del broker MQTT

Asegúrese de la accesibilidad del broker MQTT:

• Misma red: La cámara debe alcanzar la dirección IP del broker
• Acceso al puerto: Puerto MQTT predeterminado 1883 (o 8883 para TLS)
• Autenticación: Nombre de usuario/contraseña si el broker lo requiere
• Cortafuegos: Permitir tráfico MQTT en los puertos requeridos

1.3 Requisitos de red

Componente	Dirección IP	Puerto	Notas
Cámara	10.250.0.100	N/A	Debe alcanzar el broker
Broker MQTT	10.250.0.200	1883	Puerto estándar de MQTT
Dispositivos Cliente	10.250.0.xxx	Variable	Cualquier dispositivo suscrito

Paso 2: Acceder al Editor de Node-RED

2.1 Navegar al Bloque IO

1. Abra su receta activa en el Editor de Recetas
2. Haga clic en Configurar IO o seleccione Bloque IO en el menú de migas de pan para ingresar al editor de Node-RED

2.2 Verificar nodos MQTT disponibles

Verifique la paleta de Node-RED para nodos MQTT:

• mqtt in - Suscribirse a temas MQTT
• mqtt out - Publicar en temas MQTT

Punto de control: Debería ver nodos MQTT en la sección de Red del panel izquierdo.

Paso 3: Configurar la conexión del broker MQTT

3.1 Agregar configuración del broker MQTT

1. Arrastre el nodo "mqtt in" al lienzo (para la configuración inicial)
2. Haga doble clic en el nodo para abrir la configuración
3. Haga clic en el ícono de lápiz junto al campo del Servidor
4. Haga clic en "Agregar nuevo mqtt-broker"

3.2 Configurar la configuración del broker

Configuración básica del broker:

Configuración	Valor	Descripción
Nombre	Camera MQTT Broker	Identificador descriptivo
Servidor	192.168.0.200	Dirección IP del broker MQTT
Puerto	1883	Puerto estándar de MQTT
Protocolo	MQTT V3.1.1	Versión recomendada
ID de Cliente	(auto-generar)	Dejar en blanco para automático

3.3 Configuración de Autenticación (Si es Requerida)

Si el broker requiere autenticación:

Configuración	Descripción
Nombre de usuario	Nombre de usuario del broker MQTT
Contraseña	Contraseña del broker MQTT
Usar TLS	Habilitar para conexiones seguras (puerto 8883)

3.4 Configuraciones Avanzadas

Opciones de Conexión:

Configuración	Valor Recomendado	Descripción
Keep Alive	60 segundos	Intervalo de latido
Sesión Limpia	Verdadero	Comenzar de nuevo en cada conexión
Conexión Automática	Verdadero	Reconectar automáticamente

3.5 Guardar Configuración del Broker

1. Haga clic en "Agregar" para guardar la configuración del broker
2. Haga clic en "Listo" para cerrar la configuración del nodo
3. La configuración del broker ahora está disponible para todos los nodos MQTT

Paso 4: Configurar MQTT de Entrada (Suscribirse)

4.1 Configurar Nodo MQTT In

1. Seleccione el nodo "mqtt in" que agregó
2. Haga doble clic para configurar
3. Configure las configuraciones de suscripción:

4.2 Configuración de MQTT In

Configuraciones de Suscripción:

Configuración	Valor de Ejemplo	Descripción
Servidor	Broker MQTT de la Cámara	Seleccione el broker configurado
Tema	camera/commands	Tema al que suscribirse
QoS	0	Calidad de entrega del mensaje
Salida	auto-detectar	Formato del mensaje
Nombre	Escuchador de Comandos	Identificador del nodo

4.3 Convenciones de Nomenclatura de Temas

Estructura de tema recomendada:

Propósito	Ejemplo de Tema	Uso
Comandos	camera/commands	Recibir comandos de control
Solicitudes de estado	camera/status/request	Solicitudes de información de estado
Configuración	camera/config	Cambios de configuración

4.4 Configurar Procesamiento de Mensajes

1. Agregue un nodo "debug" para monitorear los mensajes entrantes
2. Conectar: MQTT In → Debug
3. Configure el nodo de depuración para mostrar el mensaje completo

Paso 5: Configurar MQTT de Salida (Publicar)

5.1 Agregar Nodo MQTT Out

1. Arrastre el nodo "mqtt out" al lienzo
2. Haga doble clic para configurar
3. Seleccione la misma configuración de broker

5.2 Configuración de MQTT Out

Configuraciones de Publicación:

Configuración	Valor de Ejemplo	Descripción
Servidor	Broker MQTT de la Cámara	Mismo broker que la entrada
Tema	camera/responses	Tema para respuestas de la cámara
QoS	0	Calidad de entrega del mensaje
Retener	Falso	No almacenar el último mensaje
Nombre	Publicador de Respuestas	Identificador del nodo

5.3 Estructura de Tema de Respuesta

Temas de respuesta recomendados:

Tipo de Respuesta	Ejemplo de Tema	Uso
Actualizaciones de estado	camera/status	Información de estado de la cámara
Resultados	camera/results	Resultados de inspección
Reconocimientos	camera/ack	Confirmaciones de comandos

Paso 6: Crear Flujo de Comunicación Básico

6.1 Construir Flujo de Mensaje Saliente

Cree un flujo para publicar mensajes desde la cámara:

1. Agregue un nodo "inject" para activar mensajes
2. Agregue un nodo "function" para formatear mensajes
3. Agregue un nodo "mqtt out" para publicar
4. Conectar: Inject → Function → MQTT Out

6.2 Construir Flujo de Mensaje Entrante

Cree un flujo separado para recibir mensajes:

1. Agregue un nodo "mqtt in" para suscribirse
2. Agregue un nodo "debug" para monitorear
3. Conectar: MQTT In → Debug

6.3 Configurar Nodo Inject

1. Haga doble clic en el nodo inject
2. Configurar ajustes:
   • Nombre: "Enviar Mensaje de Prueba"
   • Carga útil: Timestamp
   • Tema: (dejar vacío)
3. Haga clic en "Listo"

6.4 Configurar Nodo Function

Formato de mensaje simple:

// Format outgoing message
msg.topic = "camera/status";
msg.payload = "Camera online - " + new Date().toISOString();
return msg;

1. Haga doble clic en el nodo function
2. Copie el código anterior en la pestaña "On Message"
3. Nombre: "Formatear Mensaje"
4. Haga clic en "Listo"

6.5 Configurar Nodo MQTT Out

1. Haga doble clic en el nodo mqtt out
2. Seleccione broker: Camera MQTT Broker (configurado anteriormente)
3. Tema: (dejar vacío - configurado por el nodo function)
4. Nombre: "Publicar Estado"
5. Haga clic en "Listo"

6.6 Configurar Nodo MQTT In

1. Haga doble clic en el nodo mqtt in
2. Seleccione broker: Camera MQTT Broker
3. Tema: camera/commands
4. Nombre: "Escuchador de Comandos"
5. Haga clic en "Listo"

6.7 Configurar Nodo Debug

1. Haga doble clic en el nodo debug
2. Salida: Objeto msg completo
3. Nombre: "Mensajes Entrantes"
4. Haga clic en "Listo"

6.8 Estructura Final del Flujo

Su flujo completo debería ser:

Saliente: Inject → Function → MQTT Out
Entrante: MQTT In → Debug

Paso 7: Desplegar y Probar Configuración

7.1 Desplegar Flujo

1. Haga clic en el botón "Desplegar" (esquina superior derecha)
2. Verifique el mensaje de éxito del despliegue
3. Revise los indicadores de estado de los nodos:
   • Punto verde: Conectado al broker
   • Punto rojo: Conexión fallida
   • Punto amarillo: Conectando

7.2 Probar Comunicación Interna

Pruebe la publicación MQTT de la cámara:

1. Haga clic en el botón inject para enviar un mensaje de prueba
2. Verifique que el nodo MQTT Out muestre actividad
3. Revise el panel de debug si tiene mensajes externos

7.3 Pruebas Externas (Opcional)

Pruebe con un cliente MQTT externo para enviar comandos a la cámara:

Usando herramientas de línea de comandos:

# Send a test command to the camera
mosquitto_pub -h 10.250.0.100 -t "camera/commands" -m "test_command"

Resultado esperado: El nodo debug debería mostrar el mensaje entrante en el panel de debug de Node-RED.

7.4 Verificar Comunicación

Revise estos aspectos:

Prueba	Resultado Esperado	Estado
Conexión al broker	Estado verde en nodos MQTT	☐
Publicación de mensajes	Inject activa MQTT Out con éxito	☐
Recepción de mensajes	Debug muestra mensajes externos	☐
Reconexión	Reconexión automática después de interrupción de red	☐

Paso 8: Solución de Problemas de MQTT

8.1 Problemas de Conexión

Problema	Síntomas	Solución
No se puede conectar al broker	Indicadores de estado rojos	Verifique la IP y el puerto del broker
Fallo de autenticación	Conexión rechazada	Verifique nombre de usuario/contraseña
Timeouts de red	Estado amarillo conectando	Verifique la conectividad de red
Firewall bloqueando	Sin intento de conexión	Abra los puertos MQTT

8.2 Problemas de Mensajes

Problema	Síntomas	Solución
No se reciben mensajes	Debug no muestra nada	Verifique las suscripciones de tema
Mensajes no publicados	Clientes externos no ven nada	Verifique los temas de publicación
Errores de formato de mensaje	Fallos de análisis	Use mensajes de texto simples
Mensajes perdidos	Entrega intermitente	Verifique la conexión al broker

8.3 Problemas de Rendimiento

Problema	Síntomas	Solución
Alta latencia	Entrega de mensajes retrasada	Verifique el rendimiento del broker
Caídas de conexión	Reconexiones frecuentes	Ajuste la configuración de keep-alive
Inundación de mensajes	Sobrecarga del broker	Implemente limitación de mensajes

8.4 Técnicas de Depuración

Solución de problemas sistemática:

1. Verifique el estado de conexión del broker en Node-RED
2. Monitoree el panel de depuración de Node-RED para el flujo de mensajes
3. Utilice mensajes de texto simples antes de datos complejos
4. Verifique la conectividad de red con ping
5. Pruebe con temas básicos antes de flujos avanzados

¡Éxito! Su Comunicación MQTT Está Lista

Su sistema de comunicación MQTT ahora puede:

• Conectarse a brokers MQTT con la autenticación adecuada
• Suscribirse a temas para recibir comandos y datos
• Publicar mensajes para actualizaciones de estado y respuestas
• Manejar formatos de mensajes JSON para comunicación estructurada
• Reconectarse automáticamente después de interrupciones de red
• Soportar múltiples niveles de QoS para diferentes prioridades de mensajes

Mantenimiento Continuo

Revisiones Regulares del Sistema

• Monitoree el estado de conexión del broker en Node-RED
• Verifique la entrega de mensajes con mensajes de prueba
• Revise los registros del broker en busca de patrones de error
• Actualice las credenciales de autenticación según sea necesario

Monitoreo del Rendimiento

• Rastrear la latencia de mensajes y los tiempos de entrega
• Monitorear el uso de recursos del broker para escalabilidad
• Analizar patrones de uso de temas para optimización
• Revisar configuraciones de QoS según los requisitos reales

Próximos Pasos

Después de configurar la comunicación básica MQTT:

1. Implemente flujos de mensajería específicos para su aplicación
2. Establezca jerarquías de temas para una comunicación organizada
3. Agregue medidas de seguridad como cifrado TLS
4. Integre con sistemas externos utilizando protocolos MQTT establecidos
5. Cree paneles de monitoreo para la salud del sistema

Genere flujos MQTT automáticamente

El Integration Builder puede generar flujos completos de comunicación MQTT a partir de una descripción en inglés simple. Describa su patrón de mensajería (por ejemplo, "publicar resultados de inspección en un tema MQTT con estado de aprobado/reprobado y puntajes de confianza") y obtenga un flujo de Node-RED listo para producción en segundos.

🔗 Ver También

• Trigger over MQTT
• Configuración de Comunicación TCP
• Configuración de Comunicación RS-232
• Conectar a PLC (Ethernet/IP, PROFINET)
• Conceptos Básicos de Node-RED