Modifications

Le bundle Adafruit et les releases sont des versions optimisées des bibliothèques Adafruit avec l'extension de fichier {{fname|.mpy}}. Ces fichiers prennent moins de place sur le lecteur et un impact en mémoire moins important quand ils sont chargés.

Le bundle Adafruit et les releases sont des versions optimisées des bibliothèques Adafruit avec l'extension de fichier {{fname|.mpy}}. Ces fichiers prennent moins de place sur le lecteur et un impact en mémoire moins important quand ils sont chargés.

== Installing the bundle ==

== Installer un bundle ==

We're constantly updating and improving our libraries, so we don't (at this time) ship our CircuitPython boards with the full library bundle. Instead, you may find example code that depends on ({{fname|import}}) libraries. Some of these libraries may be available from us at Adafruit, some may be written by community members!

Adafruit améliore constamment ses bibliothèques, bibliothèques qui sont mises-à-jour régulièrement. La totalité des bibliothèques ne sont donc pas incluses (pour le moment) sur les cartes CircuitPython. Par conséquent, vous pourriez trouver des codes d'exemples qui utilise certaines bibliothèques (instruction {{fname|import}}) de chargement de bibliothèques). Certaines de ces bibliothèques pourraient être disponible depuis Adafruit, d'autres écrites par des membres de la communauté!

Either way, once you get past the most basic blink scripts, you'll want to know how to get libraries on board. So, lets take a look at this silly example below which uses a SI7021 I2C temperature sensor.

Quoi qu'il en soit, une fois passer l'exemple blink (exemple simple qui fait clignoter une LED), vous aurez besoin de savoir comment obtenir la bibliothèque et la charger sur votre carte.

 

Jetons un petit coup d'oeil sur l'exemple, ci-dessous, utilisant le senseur de température SI7021 (bus I2C).

<syntaxhighlight lang="python">import adafruit_si7021

<syntaxhighlight lang="python">import adafruit_si7021

sensor = adafruit_si7021.SI7021(i2c)

sensor = adafruit_si7021.SI7021(i2c)

print("Temperature:", sensor.temperature)

print("Temperature:", sensor.temperature)

print("Humidity:", sensor.relative_humidity)

print("Humidite:", sensor.relative_humidity)

</syntaxhighlight>

</syntaxhighlight>

After saving that as {{fname|code.py}} on the drive we see the status NeoPixel flashes that an error has occurred. Opening up the serial console we see that an <code class="prettyprint">ImportError</code> has occurred.

Après avoir sauvé ce code dans le fichier {{fname|code.py}} sur le lecteur, nous pouvons voir la LED NeoPixel affichier un statur d'erreur (elle flash). En utilisant la console série nous pouvons constater qu'une erreur '''ImportError''' s'est produite.

{{ADFImage|FEATHER-M0-MicroPython-bibliotheque-02.png|480px}}

{{ADFImage|FEATHER-M0-MicroPython-bibliotheque-02.png|480px}}

It says that no module exists named {{fname|adafruit_si7021}}. Thats the library we need to download! Since we bought the sensor from Adafruit its likely there is a library for in [https://github.com/adafruit/Adafruit_CircuitPython_Bundle/releases/latest the official Adafruit bundle]. If its not an Adafruit part or its missing, we can also check [https://github.com/adafruit/CircuitPython_Community_Bundle/releases/latest the Community bundle] which has libraries contributed by the community.

L'erreur indique qu'il n'existe pas de module nommé {{fname|adafruit_si7021}}. C'est la bibliothèque que nous avons besoin de télécharger! Etant donné que le senseur provient d'Adafruit, il y a fortes chances d'y trouver la bibliothèque depuis [https://github.com/adafruit/Adafruit_CircuitPython_Bundle/releases/latest le bundle officiel d'Adafruit]. S'il ne s'agit pas d'un composant Adafruit ou s'il est manquant dans le bundle officiel, vous pouvez vérifier le [https://github.com/adafruit/CircuitPython_Community_Bundle/releases/latest the Community bundle] (''le bundle communautaire'') qui dispose de bibliothèques auxquels contribue la communauté.

{{download-box|Cliquer ici pour obtenir la dernière version du bundle d'Adafruit|https://github.com/adafruit/Adafruit_CircuitPython_Bundle/releases/latest}}

{{download-box|Cliquer ici pour obtenir la dernière version du bundle d'Adafruit|https://github.com/adafruit/Adafruit_CircuitPython_Bundle/releases/latest}}

Visiting the bundle release page will show us information on the latest release including a list of all the versions of the included drivers. Scrolling to the bottom of the page will reveal the downloads. We'll download the first zip file which starts with {{fname|adafruit-circuitpython-bundle}}.

Visiter la page release du bundle qui affiche des informations sur la dernière release incluant une liste de toutes les versions et liste des pilotes inclus dans la release. Faire défiller la page jusqu'en bas affiche les téléchargements ("''Downloads''"). Bien, commencons par le premier fichier zip qui commence par {{fname|adafruit-circuitpython-bundle}}.

{{ADFImage|FEATHER-M0-MicroPython-bibliotheque-03.png|480px}}

{{ADFImage|FEATHER-M0-MicroPython-bibliotheque-03.png|480px}}

{{ADFImage|FEATHER-M0-MicroPython-bibliotheque-04.png|480px}}

{{ADFImage|FEATHER-M0-MicroPython-bibliotheque-04.png|480px}}

After downloading the zip, extract its contents. This is usually done by double clicking on the zip. On Mac OSX as I'm using, it places the file in the same directory as the zip. I usually sort my Downloads by file data so the {{fname|lib}} directory that was contained in the zip ends up next to the zip file.

Après avoir téléchargé le zip et extrait le contenu. Cela se fait habituellement en double-cliquant sur le fichier zip. Sur un Mac OSX cela extrait les fichiers dans le même répertoire que le fichier zip. Le fichier zip contient un répertoire {{fname|lib}}.

{{ADFImage|FEATHER-M0-MicroPython-bibliotheque-05.png|480px}}

{{ADFImage|FEATHER-M0-MicroPython-bibliotheque-05.png|480px}}