Gateway con HiveMQ Edge

Cos'e HiveMQ Edge

HiveMQ Edge e un software gratuito che trasforma il tuo computer Linux (o Raspberry Pi) in un gateway industriale. Ha un bridge OPC UA a MQTT nativo — non hai bisogno di plugin aggiuntivi.

Vantaggi:

• Gratuito e open source
• Bridge OPC UA nativo (senza plugin)
• Interfaccia web per la configurazione
• Supporto per Modbus, S7, EtherNet/IP oltre a OPC UA
• Buffer locale se la connessione internet viene persa

Cosa ti serve

• Computer Linux (Ubuntu 20.04+, Raspberry Pi OS, o simile)
• Java 11+ installato
• Cavo ethernet per la rete del PLC
• Accesso a internet
• Dati del PLC: IP, porta OPC UA, Node ID

Passo 1: Installare HiveMQ Edge

# Scaricare l'ultima versione
wget https://github.com/hivemq/hivemq-edge/releases/latest/download/hivemq-edge.zip

# Decomprimere
unzip hivemq-edge.zip
cd hivemq-edge

# Verificare Java
java -version  # Deve essere 11+

# Avviare
./bin/run.sh

Accedi all'interfaccia web: http://localhost:8080

Credenziali predefinite: admin / hivemq

A cosa serve

• Usare HiveMQ Edge quando il team preferisce una soluzione industriale supportata commercialmente rispetto a Node-RED.
• Fare bridge OPC UA su MQTT con buffering locale se la connessione internet cade.
• Avere telemetria sul gateway stesso (HiveMQ espone metriche Prometheus).

Come funziona

Installi HiveMQ Edge su un server o MiniPC, configuri il bridge OPC UA → MQTT puntando a Rela, attivi il buffering locale. Il gateway mantiene una coda persistente — se internet cade, salva gli eventi localmente e li sincronizza al ritorno. HiveMQ espone le proprie metriche integrabili col monitoring aziendale.

Passo 2: Configurare il bridge OPC UA

Nell'interfaccia web di HiveMQ Edge:

1. Vai su Protocol Adapters → OPC UA → Add New
2. Configura:
   • Name: PLC-Linea1 (nome descrittivo)
   • Server URL: opc.tcp://<IP-del-PLC>:4840
   • Publish Topic: impianto-nord/gateway-linea1
   • Subscriptions: aggiungi i Node ID che vuoi monitorare
3. Payload Format: seleziona OPC UA Pub/Sub JSON se disponibile, oppure JSON come alternativa
4. Clicca su Save e poi su Start

Passo 3: Configurare il bridge MQTT remoto

Se il tuo broker MQTT e su internet (non locale), configura un bridge MQTT:

1. Vai su Bridges → MQTT → Add New
2. Configura:
   • Remote Broker: mqtt://broker.hivemq.com:1883 (o il tuo broker)
   • Username/Password: credenziali del broker
   • Topics: mappa il topic locale a quello remoto (di solito lo stesso)
3. Save e Start

Passo 4: Verificare

# Da un'altra macchina, sottoscrivi al topic
mosquitto_sub -h broker.hivemq.com -t "impianto-nord/gateway-linea1" -v

Dovresti vedere messaggi JSON ogni volta che un valore cambia nel PLC.

Passo 5: Configurare Rela-ai

1. Nella dashboard, crea una sorgente con protocollo OPC UA → Via Gateway MQTT
2. Configura l'URL del broker e il topic
3. Rela-ai riceve i dati automaticamente

Formato del payload

HiveMQ Edge invia i dati in formato JSON. Se il formato non e OPC UA Pub/Sub JSON nativo, puoi usare una Data Policy in HiveMQ Edge per trasformare il payload prima dell'invio.

Formato atteso da Rela-ai:

{
  "MessageType": "ua-data",
  "PublisherId": "PLC-Linea1",
  "Messages": [{
    "Payload": {
      "Temperature": {"Value": 75.5, "StatusCode": 0},
      "Pressure": {"Value": 1.2, "StatusCode": 0}
    }
  }]
}

Consigli

• Avvio automatico: Configura HiveMQ Edge come servizio systemd in modo che si avvii automaticamente all'accensione.
• PLC multipli: Puoi aggiungere piu adattatori OPC UA, uno per ogni PLC, pubblicando su topic diversi.
• Monitoraggio: L'interfaccia web mostra metriche in tempo reale: messaggi/secondo, connessioni attive, errori.
• Sicurezza OPC UA: Configura certificati e autenticazione nell'adattatore se il PLC lo richiede.

Benefici chiave

• Supporto commerciale HiveMQ — adatto a organizzazioni che richiedono SLA.
• Buffering persistente — tollera interruzioni di internet senza perdere eventi.
• Metriche Prometheus native per integrazione con Grafana aziendale.
• Config dichiarativa per file — versionabile in git.
• Scala da 100 a 10.000 tag senza cambiare il setup.