Configurar un gateway industrial

¿Para qué sirve?

• Agregar un gateway cuando el equipamiento en planta no puede ser conectado directamente a Rela AI.
• Traducir protocolos legacy a MQTT/OPC UA que Rela consume nativamente.
• Aislar la red industrial de Internet por seguridad corporativa.

¿Cómo funciona?

El gateway es un dispositivo (Raspberry Pi, industrial PC, PLC+OPC UA) que corre Node-RED o HiveMQ Edge. Se conecta al PLC legacy por su protocolo nativo, traduce los valores a MQTT o a un endpoint HTTP de Rela, y mantiene la sesión viva. Rela consume esos eventos exactamente igual que si vinieran del equipo original.

Qué es un gateway

Un gateway es un mini computador que se instala en la planta, al lado de los PLCs. Su trabajo es simple: leer datos de las máquinas por red local (OPC UA, Modbus, S7) y publicarlos por internet via MQTT para que Rela-ai los reciba en la nube.

PLC (red local) → Gateway (traduce) → Broker MQTT (internet) → Rela-ai (nube)

Ventaja principal: El PLC nunca se expone a internet. El gateway es el único dispositivo que necesita conexion a internet. No se requiere VPN ni abrir puertos en el firewall.

Cuál gateway elegir

Recomendacion: Para empezar, usa Raspberry Pi + Node-RED (guia paso a paso disponible). Si necesitas un entorno mas robusto, usa HiveMQ Edge (guia disponible).

Requisitos previos

Antes de configurar el gateway, necesitas:

1. Datos del PLC: dirección IP, puerto, protocolo (OPC UA, Modbus, S7), y los nodos/registros a monitorear. El técnico de automatización de la planta los proporciona.
2. Broker MQTT: URL del broker, credenciales (usuario/password), y el topic donde publicar. Rela-ai te proporciona estos datos al crear la fuente en el dashboard.
3. Red: El gateway debe tener acceso a la red local del PLC (cable ethernet) y acceso a internet (WiFi o ethernet).

Configuración en Rela-ai

1. En el dashboard, ve a Alarmas → Fuentes → Crear fuente
2. Selecciona protocolo OPC UA
3. Selecciona modo Via Gateway MQTT
4. Llena los campos:
   • Broker URL: la URL del broker MQTT (ej: mqtt://broker.hivemq.com:1883)
   • Topic: el topic donde el gateway publica (ej: planta-norte/gateway-linea1)
   • QoS: 0 para la mayoria de casos
5. Guarda la fuente. Rela-ai empieza a escuchar el topic automáticamente.

Formato de datos (OPC UA Pub/Sub JSON)

El gateway debe enviar datos en formato OPC UA Pub/Sub JSON (Part 14 del estandar). Este es el formato que Rela-ai espera:

{
  "MessageType": "ua-data",
  "PublisherId": "PLC-Linea1",
  "Messages": [
    {
      "DataSetWriterId": 1,
      "Payload": {
        "Temperature": {"Value": 75.5, "SourceTimestamp": "2026-04-03T12:00:00Z", "StatusCode": 0},
        "Pressure": {"Value": 1.2, "SourceTimestamp": "2026-04-03T12:00:00Z", "StatusCode": 0}
      }
    }
  ]
}

Cada campo en Payload se convierte en un evento independiente en Rela-ai.

Troubleshooting

Guias especificas

• Raspberry Pi + Node-RED — paso a paso completo
• HiveMQ Edge — configuración del bridge OPC UA nativo

Beneficios clave

• Conecta equipos legacy sin migrar PLCs.
• Mantiene la red industrial separada de Internet — el gateway es el único puente.
• Funciona con hardware commodity (Raspberry Pi, MiniPC).
• Node-RED o HiveMQ Edge según preferencia del equipo de IT.
• Instrucciones paso-a-paso para ambas opciones en páginas dedicadas.