Exécuter CLI Particle dans n'importe quel système d'exploitation pour gérer les bibliothèques localement

Travaillez-vous avec des périphériques Particle pour construire votre prochain projet IoT Si votre réponse est oui, vous êtes au bon endroit.

Particle environnement de développement intégré facile à utiliser appelé Particle Build , qui vous permet de faire du développement de logiciels dans un environnement basé sur le cloud et convivial, avec le plus qui peut être exécuté dans votre navigateur Web à partir de n'importe quelle partie du monde.

Comme option d'addition à l'IDE Web, ils fournissent également l' interface de ligne de commande (CLI) , un outil puissant vous permettant de communiquer avec Particle Particle une ligne de commande ou une application de terminal. Il vous permet de prendre un contrôle total sur votre environnement de développement en gérant tous les projets localement. Les fonctionnalités telles que la possibilité de réclamer et de flasher les appareils, de gérer vos propres bibliothèques et de périphériques, et bien plus encore, sont incluses.

En suivant ce guide, vous apprendrez à installer la Particle dans n'importe quel système d'exploitation , en plus de la gestion des bibliothèques externes incluses dans votre projet, puis de le flasher à n'importe quelle Particle .

Sans plus tarder... Commençons ! ;)

Exigences

• Toute planche Particle .
• Un ordinateur MacOS/Linux ou Windows.
• Câble de communication USB.
• Ligne de commande ou application de terminal (cela dépend de votre système d'exploitation).

Table des matières

1. Installation de CLI Particle
2. Accéder à votre compte Particle
3. Configurer votre projet
   - Création du dossier projet
   - Configuration de la bibliothèque
   - Création d'exemples de code
   - Compilation du projet
   - Flashage du projet

Installation de CLI Particle

• MacOS/Linux

Ouvrez un terminal et exécutez la commande suivante :

bash <(curl -sl https: //particle.io / install-cli)

Comme vous pouvez le voir ci-dessous, la commande tentera d'installer DFU-util . Il s'agit d'un logiciel utilitaire permettant de programmer des appareils via USB . Si le programme d'installation ne parvient pas à installer automatiquement le logiciel utilitaire, consultez les instructions d'installation de l'utilitaire DFU ici .

• Fenêtres

Téléchargez et exécutez le programme d'installation de Windows CLI pour installer la CLI Particle

Remarque importante: Pour une installation avancée de la Particle dans votre ordinateur, nous vous recommandons de vérifier les instructions Particle pour en assurer la bonne fonctionnalité.

Accéder à votre compte Particle

Dans la ligne de commande ou dans l'application de terminal, exécutez la commande ci-dessous :

connexion particle 

Cette commande vous demandera votre adresse e-mail, ainsi que le mot de passe associé à votre compte Particle .

Dans le cas où vous n'avez pas de particle , exécutez la configuration particle et suivez les instructions fournies.

Conseil de pro : l' aide particle répertorie toutes les commandes disponibles dans la Particle

Configurez votre projet

Pour configurer correctement votre projet, vous devriez déjà avoir le code à flasher dans votre carte Particle , et en outre, les bibliothèques requises par elle.

À titre d'exemple général, nous allons montrer comment compiler et flasher un photon Particle pour envoyer des données à Ubidots via HTTP à l'aide de la Ubidots localement .

1. Créez un dossier de projet avec le nom de votre choix et dans n'importe quel dossier parent. Dans notre cas, nous avons créé un nouveau dossier appelé " particle -Photon " à l'intérieur " Desktop "

2. Accédez au référentiel GitHub , téléchargez la bibliothèque en tant que zip dans votre dossier de téléchargements et décompressez-le sur votre dossier « particle -Photon » précédemment créé.

3. Ouvrez un terminal et accédez au dossier de votre projet à l'aide des cd et ls . À ce stade, vous devriez déjà avoir la bibliothèque décompressée sur ce dossier.

4. Vous devez maintenant ajouter le code C++ (.cpp) suivant dans votre dossier de projet pour commencer à envoyer des données à Ubidots via HTTP.

Avant d'enregistrer l'exemple de code dans le dossier du projet, assurez-vous d'attribuer un jeton Ubidots à partir de votre compte, à l'endroit indiqué dans le code.

// Cet exemple envoie des données à plusieurs variables vers // Ubidots via le protocole HTTP. /****************************************** * Inclure les bibliothèques ****** ********************************/ #include "Ubidots.h" /******* ********************************* * Définir les instances et les constantes ************* ****************************/ #ifndef UBIDOTS_TOKEN #define UBIDOTS_TOKEN "Votre_Token" // Mettez ici votre TOKEN Ubidots #endif Ubidots ubidots(UBIDOTS_TOKEN, UBI_HTTP); /****************************************** * Fonctions auxiliaires ****** ********************************/ //Mettez ici vos fonctions auxiliaires /******* ********************************* * Fonctions principales ************** **************************/ void setup() { Serial.begin(115200); //ubidots.setDebug(true); // Décommentez cette ligne pour imprimer les messages de débogage } void loop() { float value1 = analogRead(A0); valeur flottante2 = analogRead (A1); valeur flottante3 = analogRead (A2); ubidots.add("Variable_Name_One", valeur1); // Modification du nom de votre variable ubidots.add("Variable_Name_Two", value2); ubidots.add("Variable_Name_Three", valeur3); bool bufferSent = faux ; bufferSent = ubidots.send(); // Enverra les données à une étiquette de périphérique qui correspond à l'ID du périphérique if(bufferSent){ // Faire quelque chose si les valeurs ont été envoyées correctement Serial.println("Valeurs envoyées par le périphérique"); } délai (5000); }

Une fois les codes créés et correctement enregistrés dans votre dossier de projet, vous devriez avoir quelque chose de similaire à l'image ci-dessous :

5. Exécutez la commande suivante pour compiler le CPP ( sendvalueshttp.cpp ) ciblant votre Particle :

particle Compile Photon - Target 1.0.1 Sendvalueshttp.cpp ubidots-particle-Master / Src / * - SAVETO Sendvalueshttp.bin

Après avoir exécuté cette commande, un fichier bin sera créé sous le nom de « sendValuesHTTP.bin ».

Remarque: La commande Compile peut être appliquée à n'importe quel Particle , il vous suffit de modifier le type de périphérique à laquelle la commande ciblera. Pour plus d'informations, visitez la documentation officielle Particle .

6. Connectez votre photon Particle , sur USB et placez-le en mode DFU selon les documents Particle .

7. Exécutez la commande suivante pendant que l'appareil est connecté via USB :

Flash particle --USB Sendvalueshttp.bin

Si tout s'est déroulé comme prévu et que les appareils ont été flashés avec succès, vous devriez recevoir un « Flash réussi ! » dans la ligne de commande.

À ce stade, vous devez attendre quelques secondes jusqu'à ce que le photon Particle se connecte à Internet; L'appareil doit clignoter Cyan pour assurer la connexion.

9. [Facultatif] Pour vérifier si vos données sont mises à jour correctement chez Ubidots , vous pouvez simplement vérifier la Ubidots en exécutant le moniteur de série particle

Résumé

Vous avez ça! - En quelques minutes, vous pouvez gérer les bibliothèques privées dans vos projets, compiler et flasher vos cartes Particle localement à l'aide de CLI Particle .

En savoir plus: accélérer vos développements IoT Particle + Ubidots

D'autres utilisateurs ont également trouvé utile :

• Connectez les dispositifs de maillage Particle aux Ubidots
• Connectez votre périphérique Particle à Ubidots à l'aide de webhooks Particle
• Connectez votre périphérique Particle sur MQTT