Broker MQTT esterno

Un dispositivo di tipo Broker MQTT esterno permette di creare un client per ricevere dei dati pubblicati su un topic da un broker MQTT.

I parametri di configurazione del dispositivo Broker MQTT esterno vanno inseriti nella apposita sezione durante la creazione del device o, se creato in precedenza, nella sua schermata di modifica di modifica. Sono richiesti:

• URL, l'indirizzo del broker MQTT al quale connettersi;
• Client ID, valore identificativo arbitrario del proprio client;
• Topic, il topic dove vengono pubblicati i dati a cui sottoscriversi;
• Username, username per la connessione al broker (se richiesto);
• Password, password per la connessione al broker (se richiesta);
• Funzione di trasformazione, corpo di una funzione javascript che processa i dati pubblicati, deve ritornare il formato supportato da Databoom.
  • Il formato dell'oggetto da ritornare nella funzione è:
    {
'device': '<deviceToken>',
'date': <jsDate>,
'signals' : [
{
'name': <signalToken>,
'value': <signalValue>
}
]
}
  • All'interno della funzione è possibile utilizzare le variabili:
    • payload, il contenuto in byte dei dati pubblicati sul topic, buffer Node.js;
    • moment, variabile per l'utilizzo della libreria Moment.js;
    • momentTimezone, variabile per l'utilizzo della libreria Moment Timezone;
• OAuth token, chiave creata nella sezione Credenziali dell'utente. Viene utilizzata per inoltrare i dati ritornati dalla funzione di trasformazione a Databoom.

Configurazione completata!

Una volta completata la procedura, Databoom inizierà a registrare i dati del dispositivo Broker MQTT esterno. Per poter consultare i dati e avere una rappresentazione corretta, seguire le indicazioni in Modifica/validazione di un segnale.