Configurare un gateway industriale

A cosa serve

• Aggiungere un gateway quando l'equipaggiamento dell'impianto non può essere collegato direttamente a Rela AI.
• Tradurre protocolli legacy in MQTT/OPC UA che Rela consuma nativamente.
• Isolare la rete industriale da Internet per sicurezza aziendale.

Come funziona

Il gateway è un dispositivo (Raspberry Pi, industrial PC, PLC+OPC UA) che esegue Node-RED o HiveMQ Edge. Si collega al PLC legacy sul suo protocollo nativo, traduce i valori in MQTT o un endpoint HTTP di Rela, e mantiene la sessione viva. Rela consuma questi eventi esattamente come se venissero dal dispositivo originale.

Cos'e un gateway

Un gateway e un mini computer installato in impianto, accanto ai PLC. Il suo compito e semplice: leggere i dati delle macchine tramite rete locale (OPC UA, Modbus, S7) e pubblicarli su internet via MQTT affinche Rela-ai li riceva nel cloud.

PLC (rete locale) → Gateway (traduce) → Broker MQTT (internet) → Rela-ai (cloud)

Vantaggio principale: Il PLC non viene mai esposto a internet. Il gateway e l'unico dispositivo che necessita di una connessione internet. Non e richiesta VPN ne apertura di porte nel firewall.

Quale gateway scegliere

Raccomandazione: Per iniziare, usa Raspberry Pi + Node-RED (guida passo a passo disponibile). Se hai bisogno di un ambiente piu robusto, usa HiveMQ Edge (guida disponibile).

Prerequisiti

Prima di configurare il gateway, ti servono:

1. Dati del PLC: indirizzo IP, porta, protocollo (OPC UA, Modbus, S7) e i nodi/registri da monitorare. Li fornisce il tecnico di automazione dell'impianto.
2. Broker MQTT: URL del broker, credenziali (utente/password) e il topic su cui pubblicare. Rela-ai fornisce questi dati alla creazione della sorgente nel dashboard.
3. Rete: Il gateway deve avere accesso alla rete locale del PLC (cavo ethernet) e accesso a internet (WiFi o ethernet).

Configurazione in Rela-ai

1. Nel dashboard, vai su Allarmi → Sorgenti → Crea sorgente
2. Seleziona il protocollo OPC UA
3. Seleziona la modalita Tramite Gateway MQTT
4. Compila i campi:
   • Broker URL: l'URL del broker MQTT (es. mqtt://broker.hivemq.com:1883)
   • Topic: il topic su cui il gateway pubblica (es. impianto-nord/gateway-linea1)
   • QoS: 0 per la maggior parte dei casi
5. Salva la sorgente. Rela-ai inizia ad ascoltare il topic automaticamente.

Formato dei dati (OPC UA Pub/Sub JSON)

Il gateway deve inviare i dati in formato OPC UA Pub/Sub JSON (Parte 14 dello standard). Questo e il formato atteso da Rela-ai:

{
  "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}
      }
    }
  ]
}

Ogni campo in Payload diventa un evento indipendente in Rela-ai.

Risoluzione dei problemi

Guide specifiche

• Raspberry Pi + Node-RED — guida completa passo a passo
• HiveMQ Edge — configurazione del bridge OPC UA nativo

Benefici chiave

• Collega equipaggiamento legacy senza migrare i PLC.
• Mantiene la rete industriale separata da Internet — il gateway è l'unico ponte.
• Funziona con hardware commodity (Raspberry Pi, MiniPC).
• Node-RED o HiveMQ Edge secondo la preferenza del team IT.
• Istruzioni passo-passo per entrambe le opzioni in pagine dedicate.