Comment créer une bibliothèque Arduino personnalisée?
Il aura besoin d'une grande quantité de travail avant de commencer à commencer avec notre projet. Bien qu'il existe une grande gamme de bibliothèques open source disponibles, nous devons parfois rédiger une bibliothèque personnalisée afin que ce guide vous aide à écrire votre toute première bibliothèque Arduino.
Comment créer une bibliothèque personnalisée Arduino
Les bibliothèques sont généralement écrites en langue C / C ++, donc pour écrire des bibliothèques Arduino, nous avons besoin d'une bonne connaissance des fonctions et des classes. Les bibliothèques sont un tas de .Fichiers CPP combinés pour exécuter un seul matériel. Les bibliothèques rendent la programmation Arduino plus facile et efficace. Nous n'avons pas à écrire un nouveau code chaque fois que nous utilisons du matériel. Les bibliothèques sont un excellent moyen de partager des codes qui économisent beaucoup de temps et de coût.
Comme Arduino est une plate-forme open source, la communauté Arduino a créé des milliers de bibliothèques. Mais il y a toujours une place pour que les nouvelles bibliothèques soient écrites ou si vous allez transformer un projet Arduino en produit, il pourrait avoir besoin d'écrire une bibliothèque distincte pour son matériel.
Avant d'aller de l'avant, allons-y rapidement la structure de base de la bibliothèque Arduino.
Une bibliothèque se compose généralement de:
- En tête de fichier (.h): Cela contient les définitions de la bibliothèque.
- Fichier source (.cpp): Cela contient le code de la bibliothèque.
- Fichier de mots clés (.SMS): Ce fichier explique les mots clés utilisés dans la bibliothèque.
- Fichier ReadMe (.SMS): Cela contient des informations supplémentaires liées à la bibliothèque Arduino.
- Exemples (INO): Des exemples aident les utilisateurs à utiliser la bibliothèque.
Tous ces fichiers aident les utilisateurs à comprendre et à exploiter des bibliothèques à Arduino.
Le En tête de fichier(.h) et fichier source(.cpp) Les deux fichiers nécessaires sont-ils nécessaires pour faire fonctionner une bibliothèque Arduino. Tous les autres fichiers sont un module complémentaire qui donne aux utilisateurs des informations nécessaires comme ce que fait cette bibliothèque ou qui est l'auteur de cette bibliothèque.
Maintenant, nous allons créer une nouvelle bibliothèque .H et .cpp déposer.
Étape 1: créer un exemple de code
Étape 2: Créer un en-tête de bibliothèque et un fichier source
Étape 3: Ajout de la bibliothèque personnalisée dans Arduino IDE
Étape 4: Appeler la bibliothèque personnalisée dans un code Arduino
Étape 1: créer un exemple de code
je: Écrivez un code simple dans l'éditeur Arduino IDE qui prendra deux nombres et additionnera les deux nombres pour afficher le résultat sur le moniteur en série:
int sum (int a, int b)retourner a + b;
void setup()
En série.commencer (9600);
int réponse = sum (1,2);
En série.println (réponse);
void loop ()
Compiler le code ci-dessus suivant la sortie apparaît dans la fenêtre de sortie. La sortie imprimera la somme de deux nombres 1 et 2.
II: Une fois le code écrit en IDE, enregistrez votre code en allant à Enregistrer sous option sous le Déposer menu:
Une nouvelle fenêtre s'ouvrira, créera un nouveau dossier MA BIBLIOTHÈQUE et enregistrer le fichier Arduino à l'intérieur de ce dossier.
Une fois le nouveau dossier de bibliothèque créé, vous verrez un nouveau .ino dossier là-bas. À l'intérieur de ce fichier, nous appellerons une bibliothèque personnalisée et testerons sa sortie.
Étape 2: Créer un en-tête de bibliothèque et un fichier source
je: Créez maintenant deux fichiers principaux de la bibliothèque qui sont en en-tête et en fichier source. Pour faire cette presse «Ctrl + shif + n» ou cliquez sur l'icône de l'ellipsis sur le côté droit de l'IDE puis cliquez Nouvel onglet:
II: Une nouvelle fenêtre s'ouvrira ici et écrira le nom des fichiers que nous voulons créer. Taper Ma bibliothèque.cpp et Ma bibliothèque.H Pour créer respectivement le fichier source et d'en-tête:
III: Une fois que les deux nouveaux fichiers seront créés, l'interface IDE ressemblera à ceci. La prochaine étape consiste à écrire du code pour les fichiers source et d'en-tête afin que nous puissions appeler notre propre bibliothèque personnalisée dans le fichier de code principal.
Code pour le fichier d'en-tête
Tout d'abord, nous créerons un fichier d'en-tête pour la bibliothèque personnalisée Arduino. Tapez le code ci-dessous à l'intérieur du ".h ” déposer.
#ifndef my_library_h#define my_library_h
#inclure
int sum (int a, int b);
#fin si
Ceci est une syntaxe générale pour écrire du code pour la bibliothèque Arduino, nous commençons par définir le nom de l'en-tête et se termine par #fin si déclaration. Normalement, lors de l'écriture du nom de la tête de l'en-tête, il vaut mieux écrire dans les lettres supérieures et ajouter "_H" à la fin du nom.
Après cela, il est nécessaire d'ajouter une bibliothèque Arduino car la bibliothèque peut nécessiter l'utilisation de certaines fonctions Arduino. Dans notre programme principal normalement, il est ajouté par défaut, mais en écrivant une bibliothèque personnalisée, nous devons l'inclure nous-mêmes. Ensuite, nous avons créé une variable "SOMME" qui sera appelé par notre fichier source .cpp à l'intérieur d'une fonction.
Code du fichier source
Notre fichier d'en-tête est prêt maintenant, nous allons passer à la création de code source (.cpp déposer). Tapez le code ci-dessous dans le fichier source:
#include "My_Library.H "int sum (int a, int b)
retourner a + b;
Ici dans le code ci-dessus, nous avons commencé par appeler un fichier d'en-tête en utilisant #inclure directif. Le fichier d'en-tête contient des commentaires descriptifs inclut des fichiers tels que (#include), certaines définitions et classes constantes qui contiennent différentes fonctions et variables que nous appelons dans notre bibliothèque.
Étape 3: Ajout de la bibliothèque personnalisée dans Arduino IDE
Une fois que nous avons créé une bibliothèque Arduino, l'étape suivante consiste à l'ajouter à l'Arduino IDE afin que nous puissions l'appeler dans n'importe quel code. Pour ce faire, copiez le dossier qui contient l'en-tête de la bibliothèque et le code source, collez ce dossier dans le répertoire de la bibliothèque Arduino. Le chemin du dossier du répertoire Arduino ressemblera à ceci: Documents> Arduino> Bibliothèques:
Une fois la bibliothèque ajoutée à l'intérieur de l'ide Arduino. Nous pouvons l'appeler dans n'importe quel code en allant à: Sketch> Inclure la bibliothèque> My_Library:
Ouvrez un croquis Arduino vierge et essayez d'appeler la bibliothèque que vous venez de créer le code ressemblera à ceci:
Nous avons réussi à créer une bibliothèque pour calculer la somme de deux entiers et l'avons appelée dans le code Arduino.
Étape 4: Appeler la bibliothèque personnalisée dans un code Arduino
Comme notre bibliothèque Arduino est terminée maintenant, nous écrivons le même code de somme ci-dessus en y appelant notre bibliothèque personnalisée. Tapez le code suivant dans IDE:
#include "My_Library.H "void setup()
En série.commencer (9600);
INT Result = sum (1,2);
En série.println (résultat);
void loop ()
Dans le code ci-dessus, nous avons d'abord inclus "Ma bibliothèque.h ” Ensuite, dans la partie de configuration, nous avons commencé la communication série. La variable de résultat suivante sera appelée et la somme de deux nombres sera imprimée sur le moniteur série en appelant la fonction de résultat de la bibliothèque .cpp déposer. En appelant la bibliothèque personnalisée à l'intérieur de l'Arduino .ino Fichier Assurez-vous d'utiliser exactement le même nom de fichier que vous avez nommé le fichier d'en-tête.
Après avoir compilé le code, le même résultat est imprimé comme notre code précédent. Ici, le code est plus optimisé à l'aide d'une bibliothèque distincte.
Comment partager la bibliothèque personnalisée Arduino
Pour partager la bibliothèque Arduino, ouvrez d'abord le dossier où deux fichiers principaux avec .cpp et .H les formats sont enregistrés. Le dossier Sketch peut être ouvert en allant à: Sketch> Afficher le dossier Sketch.
Une nouvelle fenêtre s'ouvrira ici où tous les fichiers de la bibliothèque peuvent être vus. Pour partager les bibliothèques compressez d'abord ces fichiers et partagez-les à l'aide d'un fichier zip:
Conclusion
Arduino a une large gamme de bibliothèques open source disponibles, mais parfois nous avons besoin d'une bibliothèque personnalisée pour augmenter la productivité de notre projet ou pour optimiser le code. Cet article couvre toutes les étapes nécessaires pour rédiger votre propre code de bibliothèque. Principalement deux fichiers sont requis pour une bibliothèque Arduino, des fichiers de source et d'en-tête. Ces deux fichiers peuvent être créés en suivant les étapes mentionnées dans ce guide.