Collega facilmente Tulip ai dispositivi ParticleIO
Segui la guida all’integrazione della community di Particle (guida identica) qui:Integrazione della community Particle <> Tulip
Configurazione
Configurazione dell’endpoint macchina in Tulip
Per creare una macchina in Tulip sono necessari i seguenti elementi:* Credenziali API* Tipo di macchina* Credenziali API della macchina
Creare un account di servizio con la funzione di lettura/scrittura su macchine e attributi:::(Info) (Feature rename)
Prior to r383, Service Accounts were called "API Tokens".
:::
Vai su Impostazioni --> API Tulip per creare un account di servizio con la possibilità di leggere/scrivere su macchine e attributi
Tipo di macchina Vaisu Reparto di produzione --> Macchine --> Tipi di macchina e crea un nuovo tipo di macchina. Crea gli attributi della macchina in modo che rispecchino gli eventi pubblicati da ParticleIO. NOTA: il tipo di dati deve essere stringa. 
Macchina: creareuna nuova macchina sotto il tipo di macchina appena creato; nella sezione "Configurazione", mappare l’attributo della macchina all’API Tulip Machine e prendere nota dell’ID macchina (MachineId) e dell’ID attributo (AttributeId)
Abilitazione dell’integrazione
**Particle Console:**ora che hai completato tutta la preconfigurazione necessaria, sei pronto per abilitare l’integrazione Tulip sulla Particle Console.
Inizia accedendo all’hub delle integrazioni cliccando sull’icona delle integrazioni nella barra laterale (), oppure semplicemente seguendo questo link. Se desideri abilitare l’integrazione per un prodotto, dovrai visitare l’hub delle integrazioni relativo al prodotto desiderato. Per farlo, clicca sull’icona dei prodotti () nella barra laterale, individua il tuo prodotto, quindi clicca sull’icona delle integrazioni () nel contesto del prodotto.
Una volta nell’hub delle integrazioni, clicca sul pulsante “Nuova integrazione”. Dall’elenco delle integrazioni disponibili, clicca su “Webhook”.
Il passo successivo consiste nel configurare il Webhook. Compila i seguenti campi:
- Nome evento: il nome dell’evento che attiverà la pubblicazione di un evento su Tulip Machine. Si tratta del nome del tuo evento quando chiami Particle.publish() nel tuo firmware.
- URL: l’URL completo dell’API di Tulip Machine. Esempio: https://[instance].tulip.co/api/v3/attributes/report
- Tipo di richiesta: il server Tulip si aspetta una richiesta POST, quindi assicurati che sia selezionata.
- Formato della richiesta: l’impostazione predefinita è Modulo Web, ma invieremo un JSON, quindi assicurati di modificare questa opzione in JSON.
Dovrai fare clic sull’area “Impostazioni avanzate” per compilare il formato JSON personalizzato. Puoi compilarlo come segue:
{ "attributes": [ { "machineId": "machineID", "attributeId": "attributeID", "value": "{{{PARTICLE_EVENT_VALUE}}}" } ]}
Autenticazione Infine, dovrai autenticarti su Tulip utilizzando la chiave API e il segreto. Di seguito è riportato uno screenshot di esempio.
In questo caso viene utilizzata l’autenticazione Basic.
Fai clic su "Crea webhook". Ora hai indicato con successo al cloud Particle di trasmettere i dati a Tulip tramite la sua MachineAPI!
È ora di passare al firmware!
Firmware
Ora che l’integrazione è abilitata nel cloud di Particle, il passo finale necessario per far arrivare i dati in streaming su Tulip consiste nel flashare un dispositivo con un firmware che pubblichi l’evento desiderato. Accedi al Particle Web IDE, al Local IDE o a qualsiasi IDE tu stia utilizzando per lo sviluppo del firmware.
Se stai già lavorando a un'applicazione firmware, assicurati semplicemente di includere una chiamata a Particle.publish() con il nome dell'evento corrispondente a quello utilizzato per abilitare l'integrazione con Google Cloud Platform descritta sopra. Altrimenti, se hai bisogno di un firmware di esempio, incolla il codice riportato di seguito nella tua applicazione firmware:
void loop() {
// dati casuali String data = String((rand()%100)+1); // Attiva l’integrazione Particle.publish("temperature", data, PRIVATE); // Attendi 6 secondi delay(6000);}```Il codice sopra riportato pubblicherà un evento ogni 6 secondi, generando un numero casuale che verrà poi pubblicato nell’evento webook.
Procedi con il flashing del firmware utilizzando la funzione Particle.publish(), che attiverà l’integrazione con un dispositivo Particle.
Congratulazioni! Questo è tutto ciò che serve per far funzionare l’integrazione end-to-end. Il tuo dispositivo inizierà ora a pubblicare l’evento specificato, che segnalerà al cloud Particle di trasmettere il contenuto dell’evento alla tua istanza Tulip.
### Verifica che i dati raggiungano Tulip
Per assicurarti che i dati vengano pubblicati correttamente su Tulip, puoi visualizzare gli aggiornamenti delle macchine nell’area Shop Floor --> Machines
{height="" width=""}
NOTA: l’attributo potrebbe dover essere in formato stringa e quindi convertito in un secondo momento.
### Esempi di casi d’uso
L'utilizzo di schede ParticleIO come la Boron404x è ideale quando la connessione Wi-Fi è scarsa e la rete cellulare rappresenta una soluzione alternativa più veloce per la connettività dei dispositivi. I casi d'uso possono includere:\* Tracciamento dei materiali\* Monitoraggio delle macchine\* Aggiornamenti in tempo reale sulla qualità