Upy Class Libs

Description	Python libraries for the classroom
Author(s)	B. Delaup
Repository	https://gitlab.com/bdelaup/upy_class_libs
Copyright	Benoit Delaup

Bibliothèques

Télécharger Micropython

Télécharger le firmware micropython pour micro:bit v2.1.1

Utilitaire i2c

Fichier source pour micro:bit : mb_i2c_utils.py

from microbit import i2c
from mb_i2c_utils import scan_i2c_sensors

# initialisation du bus avec les paramètre par défaut
i2c.init()

# liste les périphérique I2C raccordés
addresses = scan_i2c_sensors()

# Détection du bus i2c en erreur 
# puis reboot de la carte
if len(addresses) > 5:
    machine.reset()

Driver BMP390 : pression

Fichier source pour micro:bit : mb_bmp290.py

from microbit import i2c
from mb_bmp390 import BMP3XX_I2C
bmp390 = BMP3XX_I2C(i2c, address=0x77)
bmp390.pressure_oversampling = 8
bmp.temperature_oversampling = 2

pression = bmp390.pressure
temperature = bmp390.temperature
altitude = bmp390.altitude

Driver SI1145 : uv

Fichier source pour micro:bit : mb_si1145.py

from microbit import i2c
from mb_si1145 import SI1145
si1145 = SI1145(i2c=i2c, address=0x60)

uv = sensor.read_uv()
ir = sensor.read_ir()
view = sensor.read_visible()

Driver APC220 : Radio

Fichier source pour micro:bit : mb_apc220.py

from microbit import uart, reset
from microbit import pin14, pin15
from mb_apc220 import Apc220, uart_reset

# Ouvre une fenètre de reconfiguration de l'UART 
# pour récupérer la console en cas de problème
uart_reset() 

apc = Apc220(tx=pin14, rx=pin15)

# Envoi de données
apc.send("Radio", "APC", 220)    

# Reception, attente pendant 1000 ms
val = apc.receive(1000)
if val != None:
    print ("Valeur reçue : ", val)

Driver Sen0322 : Oxygen

Fichier source pour micro:bit : mb_sen0322.py

import time
from microbit import i2c
from mb_sen0322 import Sen0322

oxygen_sensor = Sen0322(i2c, address=0x73)

# La concentration d'oxygen dans l'atmosphere est 20.94%
# La calibration n'est pas nécessaire 
# oxygen_sensor.calibrate(20.94)

# Lecture de la concentration d'oxygène
oxygen = oxygen_sensor.read_oxygen()

# Affiche jusqu'à 4 chiffre avant la virgule, 2 chiffres après
print("oxygen concentration is %4.2f %%vol"%oxygen)

Driver DHT20 : Humidité

Fichier source pour micro:bit : mb_dht20.py

from microbit import i2c
import time

dht20 = Dht20(i2c, address=0x38)

# Lecture de l'humidité

valeur_humidite = dht20.humidite
print("humidite :", valeur_humidite, "%")

Driver SIM28 ou AIR530 : GPS

Fichier source pour micro:bit : mb_gps.py

from microbit import uart, reset
from microbit import pin14, pin15
from mb_gps import Gps, uart_reset

# Ouvre une fenètre de reconfiguration de l'UART 
# pour récupérer la console en cas de problème
uart_reset()

gps = Gps(tx=pin15, rx=pin1)

# Affichage 
print(gps.latitude, gps.longitude, gps.altitude)

Exemple:

Saint etienne le molard 42 => "4543.81023,N" "00404.79479,E"

Utiliser :

• https://www.gpsvisualizer.com pour visualiser
• https://www.gpsvisualizer.com/convert_input?convert_format=gpx pour transformer en GPX

latitude, longitude
4543.81023, 00404.79479

Driver SGP30 : CO2 et COV

Fichier source pour micro:bit : mb_sgp30.py

from microbit import i2c

i2c.init() 
sgp30 = SGP30(i2c, address = 0x58)

# Affichage 
print("CO2eq:", sgp30.co2, "ppm, TVOC:", sgp30.tvoc, "ppb")

Driver pololu : distance (numerique)

Fichier source pour micro:bit : mb_pololu_dist.py

from microbit import pin1

capteur = PololuNumeric300(pin1)

# Lecture de la distance en mm
dist = capteur.read_distance_mm() 
print("Distance : ", dist)    

Driver pololu : présence (logique)

Fichier source pour micro:bit : mb_pololu_dist.py

from microbit import pin1

capteur = PololuLogic200(pin1)

# Détéction de la présence d'un objet 
# (retourne True si oui, False sinon)
presence = capteur.detect() 
print("Detection : ", presence)  

Commandes utiles

Liens

• Éditeur / simulateur officiel : https://python.microbit.org/v/3
• Documentation : https://microbit-micropython.readthedocs.io/en/v2-docs/

Log (enregistrement)

Documentation : Data logging

import log

# Définit les titre des colones
log.set_labels('Nom', "Age", timestamp=log.SECONDS)

# Affiche une copie de l'enregistrement dans la console
log.set_mirroring(True)

# Suppression des logs 
log.delete()

# Ajoute un ligne
log.add(Nom="Luke", Age = 25)

Lecture de broche

Documentation : Data logging

from microbit import pin0, pin8, button_a

# Active la resistance de "pull down" pour la lecture logique
pin8.set_pull(pin8.PULL_DOWN)

# Retourne vrai si la broche est sous tension (état logique haut)
etat = pin8.read_digital()

# retourne une valeur image de la tension appliqué
# Valeur entre 0 et 1023
U0 = pin0.read_analog() 

button_a.is_pressed() # actuellement pressé ?
button_a.was_pressed() # a été pressé ?

Fonction log

Documentation : Module math de python

import math
val = math.log(10)

Projet Cansat

Ce squelette peut être utilisé comme base pour le code. Sans obligations.

Les ... sont à compléter

Squelette

# Déclaration des bibliothèques utilisées
import math
import machine

from time import sleep_ms

from microbit import button_a, button_b
from microbit import i2c, uart, reset, display
from microbit import pin0, pin14, pin15 # Adapter en fonction du cablage
import log

from mb_i2c_utils import scan_i2c_sensors
from mb_bmp390 import BMP3XX_I2C
from mb_apc220 import Apc220, uart_reset

# Initialisation de l'enregistrement dans un fichier
# Quand un bouton est envoyé, les données sont effacée
display.clear()
display.set_pixel(0,0,9)
while not button_a.was_pressed() and not button_b.was_pressed():
    sleep_ms(1000)

log.delete()
display.set_pixel(1,0,9)

# Initialisation des capteurs
i2c.init()
addresses = scan_i2c_sensors()
if len(addresses) > 4:
    machine.reset()

# Initialisation capteur pression (voir documentataion)
...

# Initialisation radio (voir documentation)
...

# Boucle sans fin. Quel condition ?
while True :

    # Lecture pression (remplacer la valeur)
    pression = 1

    # Lecture dans U0 analogique pour le calcule de la thermistance (remplacer la valeur)
    # Rappel :  la valeur de B est une propriété de la thermistance de 10Kohm 
    #           à lire dans la documentation 
    U0 = 2
    B = 1


    # Calcul de la température (remplacer la valeur)
    temperature = 1/(math.log((1023/U0)-1)/B+1/298.15)-273.15

    # affichage pour débugger (trouver les problèmes)
    print("pression : ", pression, ", Temperature : ", temperature)
    ...

    # Enregistrement sur la carte (log.add() voir documentation)
    ...

    # Transmission radio (voir documentation)
    ... 

    # On souffle
    sleep_ms(1000)