EXOR JMobile

Databoom permette l'integrazione con l'applicazione HMI JMobile di Exor. La seguente guida illustra i passaggi da seguire su JMobile e su Databoom per poter completare la configurazione.

 

---

 

Configurazione Databoom

La comunicazione fra JMobile e Databoom viene stabilita attraverso l'utilizzo del protocollo MQTT. E' pertanto necessaria la creazione in Databoom di un dispositivo di tipo MQTT o di tipo EXOR JMobile (in tal caso viene visualizzato il form d'inserimento dei parametri MQTT), in modo da avere a disposizione i parametri corretti per completare la configurazione su JMobile.

Per la creazione del dispositivo MQTT seguire l'articolo: https://support.databoom.com/hc/it/articles/209642229

 Una volta creato il dispositivo annotare i parametri:

• Token dispositivo
• ClientId
• Topics dove si possono pubblicare dati

E' inoltre necessario creare un OAuth token per l'autenticazione della connessione (dal menù laterale Impostazioni -> Credenziali).

 

---

 

Configurazione JMobile

Per il funzionamento di base di JMobile è possibile fare riferimento all'help dell'applicazione

Alla creazione di un nuovo progetto è già disponibile nella sezione laterale di ProjectView l'interfaccia MQTT.

I parametri da inserire per la configurazione del broker sono:

• Broker address è mqtt.databoom.com
• Port è 1883
• Client ID è l'identificativo del client, visualizzabile nel dispositivo creato in Databoom
• Username è il nome utente utilizzato per l'accesso in Databoom
• Password è un OAuth token creato nella sezione Credenziali in Databoom

I parametri per la pubblicazione vanno inseriti nella sezione sottostante Data (pub)

• Topic è il topic dove si possono pubblicare dati visualizzato nel dispositivo in Databoom
• Payload contiene i dati da inoltrare a Databoom, la struttura attuale permette l'inoltro di una sola variabile per volta, ogni tag di JMobile dovrà quindi avere un payload dedicato. Il payload ha la seguente struttura:

  {
   "type": "data",
   "message": {
       "device": "02xx1a45e0",
       "date": "${timestamp}",
       "signals" : [
         {
           "name": "${tagName}",
           "value": "${value}"
         }
       ]
     }
  }    

  ${timestamp} ${tagName} ${value} sono dei segnaposto di JMobile per fare riferimento rispettivamente alla data, alla descrizione della variabile e al suo valore.

E' anche possibile autenticare la connessione utilizzando i certificati.

Per l'utilizzo dei certificati:

• Broker address è mqttcert.databoom.com
• Port è 8883
• Abilitare Enable TLS
• Copiare ed incollare i certificati dal dispositivo in Databoom

In allegato all'articolo è disponibile un progetto funzionante d'esempio.