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

María Hernández -

Travaillez-vous avec des appareils Particle pour créer votre prochain projet IoT  Si votre réponse est oui, vous êtes au bon endroit.

environnement de développement intégré (IDE) facile à utiliser appelé Particle Build , qui vous permet de développer des logiciels dans un environnement convivial basé sur le cloud, avec l'avantage de pouvoir être exécuté dans votre navigateur Web depuis n'importe quelle partie du monde. .

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

En suivant ce guide, vous apprendrez comment installer la CLI Particle dans n'importe quel système d'exploitation , ainsi que la gestion des bibliothèques externes incluses dans votre projet, puis la flasher sur n'importe quel panneau de particules.

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

Exigences

  • N’importe quel panneau de particules.
  • 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 la CLI de particules
  2. Accédez à votre compte Particules
  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 la CLI de particules

  • 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 Particle CLI.

REMARQUE IMPORTANTE : Pour une installation avancée de la CLI Particle sur votre ordinateur, nous vous recommandons de consulter les instructions officielles de Particle pour garantir son bon fonctionnement.

Accédez à votre compte Particules

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

connexion aux particules

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

Si vous n'avez pas de compte particule, exécutez la commande particule setup et suivez les instructions fournies.

CONSEIL DE PRO : L' aide des commandes de particules répertorie toutes les commandes disponibles dans le module Particules.

Configurez votre projet

Pour configurer correctement votre projet, vous devez déjà disposer du code à flasher dans votre panneau de particules, ainsi que des bibliothèques requises par celui-ci.

À titre d'exemple général, nous allons montrer comment compiler et flasher un photon de particules pour envoyer des données à Ubidots via HTTP en utilisant localement la bibliothèque Ubidots .

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é « particule-photon » dans « Bureau »

2. Allez dans le dépôt GitHub , téléchargez la bibliothèque au format ZIP dans votre dossier Téléchargements et décompressez-la sur votre dossier « particule-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 appareil Particle Photon :

compilation de particules 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 de compilation peut être appliquée à n’importe quel périphérique Particle, il vous suffit de modifier le type de périphérique auquel la commande ciblera. Pour plus d'informations, visitez la documentation officielle de Particle .

6. Connectez votre Particle Photon via USB et mettez-le en mode DFU selon la documentation Particle .

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

flash de particules --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 Particle Photon se connecte à Internet ; l'appareil doit clignoter en cyan pour assurer la connexion.

  1. [FACULTATIF] Pour vérifier si vos données sont correctement mises à jour chez Ubidots , vous pouvez simplement vérifier la Ubidots en exécutant la commande Particle Serial Monitor.

Résumé

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

En savoir plus : Accélérez vos IoT à l'aide de Particle Mesh + Ubidots

D'autres utilisateurs ont également trouvé utile :