SOMMAIRE ►
Comment créer une bibliothèque Arduino et l’intégrer dans l’IDE Arduino? Si vous vous posez une telle question, c’est que vous êtes déjà assez familier avec la programmation d’Arduno et que vous savez que les bibliothèques facilitent grandement votre travail. Voici deux exemples simples de la façon dont vous pouvez écrire une bibliothèque dans Arduino pour effectuer diverses opérations et les appeler dans votre programme avec vos propres commandes.
Ce dont vous aurez besoin
- Arduino Uno / Arduino Nano / Arduino Mega
- LED et résistance
- une breadboard
- fils de connexion
Matériel supplémentaire sur ce sujet:
Tout ce dont nous avons besoin est un éditeur de texte, Notepad. La première chose à faire est de créer un dossier pour les fichiers de bibliothèque pour Arduino IDE dans le répertoire C:\Program Files\Arduino\libraries, c’est là que sont installées les bibliothèques Arduino. Le nom du dossier, ainsi que les noms des fichiers que vous créez, peuvent être les vôtres. Pour l’exemple, nous utiliserons le nom « BlinkLed », qui reflète l’objectif de la bibliothèque.
Comment création nouvelle librairie Arduino
L’IDE Arduino dispose de nombreuses bibliothèques standard avec des exemples et de nombreuses autres bibliothèques pour divers capteurs et modules, qui peuvent être téléchargées sur Internet. Notre objectif est d’apprendre à allumer et éteindre la LED sur l’Arduino avec une seule commande et un nombre de fois déterminé. Si nous décidions d’écrire un croquis pour faire clignoter la LED, nous devrions utiliser le code suivant:
void setup() { pinMode(13, OUTPUT); } void loop() { digitalWrite(13, HIGH); delay(1000); digitalWrite(13, LOW); delay(1000); }
Comment créer nouvelle bibliothèque Arduino
La bibliothèque Arduino IDE doit comporter au moins deux fichiers: un fichier d’en-tête (avec une extension .h) et un fichier de code source (avec une extension .cpp). Le premier fichier contient la description de la classe et les variables, le second fichier contient le code du programme des méthodes. Le fichier keywords.txt permet de mettre en évidence en couleur les nouveaux types et méthodes de la bibliothèque créée dans l’IDE Arduino.
- Allez dans le répertoire C:\Program Files\Arduino\libraries;
- Créez un nouveau dossier appelé BlinkLed;
- Créer un document texte BlinkLed.h;
- Créer un document texte BlinkLed.cpp;
- Créer un document texte keywords.txt.
Création d’un fichier de bibliothèque .h
Le fichier d’en-tête contient la classe où sont déclarées les fonctions à utiliser dans le code (blink dans notre cas) et les variables. Enregistrez le code suivant dans le fichier BlinkLed.h et sauvegardez le fichier dans le dossier C:\Program Files\Arduino\libraries\BlinkLed.
#include "Arduino.h" void blink (int pin, int pause, int repeat);
Création d’un fichier de bibliothèque .cpp
Le fichier source contient le code de base de la bibliothèque. Dans exemple, trois variables sont utilisées dans le programme, qui doivent être spécifiées dans l’esquisse: pin – numéro de port, délai de pause en millisecondes, repeat – nombre de fois où la boucle for est exécutée.
#include "Arduino.h" #include "BlinkLed.h" void blink (int pin, int pause, int repeat) { pinMode(pin, OUTPUT); for (int x=0; x<=repeat; x++) { digitalWrite(pin, HIGH); delay(pause); digitalWrite(pin, LOW); delay(pause); } }
Création d’un fichier keywords.txt
Ce fichier spécifie la coloration syntaxique dans l’IDE Arduino. La fonction KEYWORD1 colore le mot orange, LITERAL1 colore le mot bleu.
BlinkLed KEYWORD1 blink KEYWORD1
Si vous voulez que la LED clignote un certain nombre de fois, vous devez utiliser une boucle for où vous pouvez définir un compteur pour répéter les opérations. En utilisant notre bibliothèque, au lieu de définir le nombre de répétitions de la boucle for, de spécifier le numéro de port Arduino de la LED et le délai entre les opérations, nous mettons simplement des variables qui sont utilisées dans le programme pour faire clignoter la LED.
Programme Arduino pour librairie BlinkLed.h
#include "BlinkLed.h" void setup() { } void loop() { blink (13, 500, 10); }
Conclusion. Ceci termine l’écriture de la bibliothèque pour Arduino. Vous pouvez également créer un dossier d’exemples dans le dossier BlinkLed, où vous pouvez placer des programmes d’exemple pour démontrer la bibliothèque. Lorsque vous ouvrez l’IDE Arduino, la bibliothèque créée peut être trouvée via la barre d’outils Fichier > Exemples / BlinkLed. Par conséquent, nous pouvons appeler la fonction blinkLed avec une seule commande.
Bonjour
Apres avoir cherché en vain a créer une bibliothèque a partir du tuto , je voudrais signaler qu’il est aussi impératif que le dossier contienne un fichier library.properties , sans quoi dans mon cas la bibliothèque ne se créait pas.
Cordialement