Tecnologia vestible

Instal·lació de biblioteques

Moltes de les funcions i altres elements que fa servir CircuitPython estan en biblioteques. Algunes d'aquestes biblioteques formen part del nucli de CircuitPython (per exemple digitalio) però altres no. Aquestes biblioteques han d'estar, si les volem fer servir, a la carpeta lib del microcontrolador.

Les biblioteques les carregarem, al començament del programa, amb la instrucció import.

import digitalio

Si volem estalviar memòria podem carregar només els elements que ens calguin de cada biblioteca fent servir from:

from digitalio import DigitalInOut, Direction, Pull

La sintaxi és diferent segons si hem importat tota la biblioteca o només elements concrets. Quan importem tota la biblioteca cal indicar a quina biblioteca pertany cada element:

import board
import digitalio

led = digitalio.DigitalInOut(board.D13)
led.direction = digitalio.Direction.OUTPUT

Si, en canvi, només importem algunes parts no indiquem el nom de la biblioteca:

import board
from digitalio import DigitalInOut, Direction

led = DigitalInOut(board.D13)
led.direction = Direction.OUTPUT

Quan haguem de fer servir una biblioteca determinada, obrirem la unitat que correspon al microcontrolador que ens apareixerà amb el nom CIRCUITPY en la llista d'unitats. A l'arrel d'aquesta unitat hi ha d'haver una carpeta anomenada lib. Si no hi és la crearem. En ella haurem de copiar les biblioteques que ens fan falta. Aquestes biblioteques poden ser fitxers (típicament amb les extensions py o mpy) o carpetes.

En aquesta pàgina podem descarregar una carpeta comprimida que conté la major part de les biblioteques disponibles per a CircuitPython. En microcontroladors amb molta memòria disponible podem copiar totes les biblioteques a la carpeta lib. En altres microcontroladors amb espai més limitat (com la placa Gemma M0) haurem de triar només les biblioteques que necessitem.

Nota: És recomanable guardar una còpia del fitxer de biblioteques en un lloc de l'ordinador on sigui fàcil trobar-lo. Així el tindrem a mà quan ens faci falta. Periòdicament, però, serà convenient actualitzar el fitxer amb la darrera versió.

Si el nostre programa intenta fer servir una biblioteca que no està correctament instal·lada ens pareixerà a la consola sèrie un missatge indicant-ho.

Amb el REPL podem obrtenir la llista d'elements d'una biblioteca. Per exemple, consultem les potes disponibles per a una placa Gemma M0:

>>> import board
>>> dir(board)
['A1', 'D2', 'RX', 'SCL', 'A2', 'D0', 'TX', 'SDA', 'A0', 'D1', 'L', 'D13', 'APA102_MOSI', 'APA102_SCK']
>>> 

Per exemple, aquests són els tres elements (a part del seu propi nom) de la biblioteca pulseio:

>>> import pulseio
>>> dir(pulseio)
['__name__', 'PulseIn', 'PulseOut', 'PWMOut']
>>> 

En algun moment ens pot fer falta creare la nostra pròpia biblioteca. En aquesat cas, és recomanable consultar aquesta pàgina, on ens expliquen com crear-la i compartir-la.

En aquest web, les fotografies marcades amb [AF] són del web d'Adafruit, les marcades amb [SF] del web d'Sparkfun i les marcades amb [AU] del web d'Arduino.

Aquesta obra d'Oriol Boix està llicenciada sota una llicència no importada Reconeixement-NoComercial-SenseObraDerivada 3.0.