Connectez facilement Tulip aux appareils ParticleIO
Suivez le guide d’intégration de la communauté Particle (guide identique) ici :Intégration communautaire Particle <> Tulip
Configuration
Configuration du point de terminaison machine Tulip
La création d’une machine dans Tulip nécessite les éléments suivants :* Identifiants API* Type de machine* Identifiants API de la machine
Identifiants API:::(Info) (Feature rename)
Prior to r383, Service Accounts were called "API Tokens".
:::
Accédez à Paramètres --> API Tulip pour créer un compte de service disposant des droits de lecture et d’écriture sur les machines et les attributs
Type de machineAccédezà « Atelier » --> « Machines » --> « Types de machines » et créez un nouveau type de machine. Créez des attributs de machine correspondant aux événements publiés par ParticleIO. REMARQUE : le type de données doit être de type chaîne de caractères. 
Machine : créezune nouvelle machine sous le type de machine nouvellement créé ; dans la configuration, associez l’attribut de la machine à l’API Tulip Machine et notez les identifiants MachineId et AttributeId
Activation de l’intégration
Console Particle: maintenant que vous avez effectué toutes les préconfigurations requises, vous êtes prêt à activer l’intégration Tulip sur la console Particle.
Commencez par vous rendre dans le centre d’intégrations en cliquant sur l’icône des intégrations dans la barre latérale (), ou en suivant simplement ce lien. Si vous souhaitez activer l’intégration pour un produit, vous devrez vous rendre dans le centre d’intégrations correspondant au produit souhaité. Pour ce faire, cliquez sur l’icône des produits () dans la barre latérale, recherchez votre produit, puis cliquez sur l’icône des intégrations () dans le contexte du produit.
Une fois dans le centre d'intégrations, cliquez sur le bouton « Nouvelle intégration ». Dans la liste des intégrations disponibles, cliquez sur « Webhook ».
L’étape suivante consiste à configurer le Webhook. Remplissez les champs suivants :
- Nom de l’événement : le nom de l’événement qui déclenchera la publication d’un événement vers Tulip Machine. Il s’agit du nom de votre événement lorsque vous appelez Particle.publish() dans votre micrologiciel.
- URL : l’URL complète de l’API Tulip Machine. Exemple : https://[instance].tulip.co/api/v3/attributes/report
- Type de requête : le serveur Tulip attend une requête POST ; assurez-vous donc que cette option est sélectionnée.
- Format de la requête : le format par défaut est « Formulaire Web », mais comme nous allons envoyer un JSON, veillez à le remplacer par « JSON ».
Vous devrez cliquer sur la section « Paramètres avancés » pour définir le format JSON personnalisé. Vous pouvez le remplir comme suit :
{ "attributes": [ { "machineId": "machineID", "attributeId": "attributeID", "value": "{{{PARTICLE_EVENT_VALUE}}}" } ]}
Authentification Enfin, vous devrez vous authentifier auprès de Tulip à l’aide de la clé API et du secret. Voir la capture d’écran ci-dessous à titre d’exemple.
Dans ce cas, l'authentification de base (Basic Auth) est utilisée.
Cliquez sur « Créer un webhook ». Vous avez désormais réussi à demander au cloud Particle de transmettre des données à Tulip via son API MachineAPI !
Il est temps de passer à votre firmware !
Firmware
Maintenant que l’intégration est activée dans le cloud Particle, la dernière étape nécessaire pour que les données soient transmises à Tulip consiste à flasher un appareil avec un firmware qui publie l’événement ciblé. Rendez-vous dans l’IDE Web de Particle, l’IDE local ou tout autre IDE que vous utilisez pour le développement de firmware.
Si vous travaillez déjà sur une application de micrologiciel, assurez-vous simplement d’inclure une fonction Particle.publish() avec un nom d’événement correspondant à celui utilisé pour activer l’intégration à Google Cloud Platform ci-dessus. Sinon, si vous avez besoin d’un exemple de micrologiciel, copiez-collez le code ci-dessous dans votre application de micrologiciel :
void loop() {
// données aléatoires String data = String((rand()%100)+1); // Déclencher l’intégration Particle.publish("temperature", data, PRIVATE); // Attendre 6 secondes delay(6000);}```Le code ci-dessus publiera un événement toutes les 6 secondes : un nombre aléatoire est généré, puis publié vers l’événement webook.
N’hésitez pas à flasher le firmware avec la fonction Particle.publish(), ce qui déclenchera l’intégration vers un appareil Particle.
Félicitations ! C’est tout ce dont vous avez besoin pour que l’intégration fonctionne de bout en bout. Votre appareil va désormais commencer à publier l’événement ciblé, ce qui indiquera au cloud Particle de diffuser le contenu de l’événement vers votre instance Tulip.
### Vérification de la réception des données par Tulip
Pour vous assurer que les données sont bien publiées sur Tulip, vous pouvez consulter les mises à jour des machines dans la section « Shop Floor » --> « Machines »
{height="" width=""}
REMARQUE : l’attribut devra peut-être être au format chaîne de caractères, puis converti ultérieurement.
### Exemples d’utilisation
L'utilisation de cartes ParticleIO telles que la Boron404x est particulièrement utile lorsque la connexion Wi-Fi est médiocre et que le réseau cellulaire constitue une solution de contournement plus rapide pour la connectivité des appareils. Les cas d'utilisation peuvent inclure :\* Suivi des matériaux\* Surveillance des machines\* Mises à jour en temps réel sur la qualité