Installation des bibliothèques (libraries) CircuitPython

Circuitpython est destiné aux microcontrôleurs où les mémoires de stockage (sram ou flash) sont faibles comparés aux ordinateurs. C’est pourquoi, vous ne trouvez que les bibliothèques les plus courantes et les plus nécessaires dans le cœur de circuitpython.

Si on veut utiliser une autre bibliothèque, il faut tout simplement la copier sur le lecteur représentant la carte : CIRCUITPY.

Dans le cas, contraire vous allez avoir une erreur de ce type :

 

Installation des dernières versions

Avoir la bonne version de circuitpython

Avant toute chose, assurez-vous d’avoir la dernière version dfe circuitpython pour votre carte :

Ou plus généralement :CircuitPython downloads

Pour installer circuitpython, vous pouvez suivre les étapes de
Installer CircuitPython sur Arduino RP2040

Les bibliothèques de CircuitPython

Attention à la version CircuitPython installée sur la carte. Par exemple si elle est en version 7.x, il faut utiliser les bibliothèques 7.x !!!

Allez à Bibliothèques circuitpython.org/libraries

Par exemple, en juin 2021, la dernière version était la 6.x et la version bêta 7.x

Contient les bibliothèques pour CircuitPython version 6.X

En juin 2021, c’est la dernière version

Contient les bibliothèques pour CircuitPython version 7.X

En juin 2021, c’est la version bêta

Ce sont les bibliothèques non compressées mpy, mais au format « lisible » python.

Pour connaitre le fonctionnement des bibliothèques

L’ensemble des exemples

Vous allez télécharger la version correspondante (en toute la dernière version stable) puis vous allez la dézipper :

À droit, vous trouvez les répertoires ou fichiers contenant les bibliothèques

Répertoire ou fichier ?

Si la bibliothèque se trouve dans un fichier, celui-ci ne se trouvera pas dans un répertoire.

Par exemple neopixel.mpy se trouve à la racine du répertoire lib :

Il faudra déposer sur CIRCUITPY ce fichier.

Par contre, la bibliothèque adafruit_ble, composé de plusieurs fichiers, se trouve dans le répertoire /lib/ adafruit_ble :

Il faudra déposer sur CIRCUITPY tout le répertoire.

Copie vers la carte

Répertoire lib sur la carte

Il est conseillé de créer un répertoire lib dans lequel vous mettrez les bibliothèques :

Cependant, il est possible de mettre les répertoires ou fichiers directement dans la racine.

Quelles bibliothèques dois-je installer ?

Soit c’est indiqué dans la documentation du programme, soit vous devez utiliser les messages d’erreurs.

Indiqué dans les documentations

Très souvent, les bibliothèques nécessaires sont indiqués :

Par tâtonnement

Vous avez un code, mais vous ne savez pas qu’elles sont les répertoires ou fichiers nécessaires.

Et bien assez simplement, vous allez tester le code et grâce aux messages d’erreurs, déduire les fichiers manquants .

Par exemple :

Indique qu’il faut copier la bibliothèque adafruit_lsm6ds sur CIRCUITPY :

Après la copie, une nouvelle erreur :

On copie également adafruit_register

Résultat final

Les deux répertoires ont été copiés dans le répertoire lib

Répertoire lib

Il est possible de mettre directement ce dont on a besoin dans la racine du lecteur :

Ce qui facilite la copie des répertoires en utilisant Envoyer vers

 

Leave a Reply