mercredi 10 juin 2020

Matrice de LEDs RGB 16 X 16 WS2812B et Arduino


J'ai récemment reçu une matrice constituée de 256 LEDs RGB qui permet de créer des animations multicolores assez impressionnantes.  


Il  m'arrive souvent, lorsque je reçois un article que j'avais commandé en ligne, de m'apercevoir qu'il est beaucoup plus petit que ce que j'avais imaginé. Cette fois, c'est tout le contraire: la matrice de LEDs forme un carré de 16 cm par 16 cm, soit environ 6 fois la surface de la carte Arduino Uno que j'ai utilisé pour la contrôler.

Les connecteurs

À l'endos du panneau, la présence de 8 câbles conducteurs pourrait laisser croire que les connexions seront complexes, mais ce n'est pas le cas. 3 connexions suffisent pour faire fonctionner la matrice:
  • Nous branchons n'importe lequel des 3 fils rouges à la borne positive d'une source de tension continue de 5 V.
  • Nous branchons le fil noir (ou un des deux fils blancs) à la masse (GND de l'Arduino et borne négative de la source de tension).
  • Un seul fil sert à la réception des instructions en provenance de l'Arduino: le fil vert identifié "DIN", que nous brancherons, par exemple, à la broche 3 de l'Arduino.
Les connexions non-utilisées servent à faciliter la combinaisons de plusieurs matrices afin de former un panneau plus grand (ce que je ne ferai pas dans cet article).

Prenez soin de bien choisir votre source de tension: 256 LEDs allumées en même temps peuvent consommer beaucoup de courant. Utiliser la sortie 5 V de l'Arduino Uno n'est pas une très bonne idée.


Installation de la bibliothèque FastLED

J'ai installé la bibliothèque FastLED par Daniel Garcia (on peut passer par le gestionnaire de bibliothèque de l'IDE Arduino).


Pour vérifier que tout fonctionne bien, je vous suggère d'essayer l'exemple "Blink" fourni avec la bibliothèque (menu Fichier - Exemples - FastLED - Blink).


Cet exemple ne fait rien de bien spectaculaire: il fait clignoter en rouge la LED numéro zéro de votre matrice. Mais il contient la liste des principales configurations possibles. Dans mon cas, j'ai décommenté la ligne dédiée au contrôleur WS2812B.


Une LED située dans un coin de la matrice s'est effectivement mise à clignoter, mais en vert, ce qui m'a permis de savoir que ma matrice est de type GRB plutôt que RGB.  En remplaçant, dans le sketch, la mention "RGB" par "GRB", la LED s'est mise à clignoter en rouge, tel que prévu.


Avec ces informations, j'ai pu essayer d'autres exemples fournis avec la bibliothèque FastLED, comme par exemple le spectaculaire "ColorPalette", à la condition de remplacer les paramètres appropriés:
  • LED_PIN: 3
  • NUM_LEDS: 256
  • LED_TYPE : WS2812B
  • COLOR_ORDER: GRB



Il nous reste toutefois à régler un petit irritant: le contrôleur WS2812B et la bibliothèque FastLED ne sont pas conçus de façon spécifique pour des matrices bi-dimensionnelles; on peut aussi les utiliser pour des rubans de LEDs. Pour cette raison, les LEDs sont simplement numérotées de 0 à 255, mais dans un ordre bien peu pratique.

Ainsi, sur ma matrice, la LED numéro 0 est celle qui est située dans le coin inférieur gauche. Sur cette ligne, les numéros augmentent à mesure qu'on se déplace vers la droite, jusqu'à la LED numéro 15. La LED numéro 16 est située juste au-dessus de la LED numéro 15, et sur cette ligne les numéros augmentent à mesure qu'on se déplace vers la gauche.

Voici un sketch qui allume chaque LED à tour de rôle, de 0 à 255. C'est une façon simple de vérifier dans quel ordre elles sont numérotées.

-
-

Installation de la bibliothèque LEDMatrix

Heureusement, il existe des bibliothèques spécialement conçues pour combler les lacunes de FastLED. J'ai choisi la bibliothèque LEDMatrix par Jorgen - VikingGod. 

Cette bibliothèque, qui doit être combinée à la bibliothèque FastLED, permet de contrôler les LEDs de la matrice à partir du numéro de ligne et du numéro de colonne. De plus, la bibliothèque met à notre disposition un certain nombre de méthodes pour faciliter le contrôle de notre matrice de LEDs:
  • DrawPixel(x, y, couleur) : pour allumer une LED en particulier
  • DrawLine(x0, y0, x1, y1, couleur): pour tracer une ligne
  • DrawRectangle(x0, y0, x1,y1, couleur): pour tracer le contour d'un rectangle
  • DrawCircle(xc,  yc,  r, couleur) pour tracer le contour d'un cercle
  • DrawFilledRectangle(x0, y0, x1,y1, couleur): pour tracer un rectangle plein
  • DrawFilledCircle(xc,  yc,  r, couleur) pour tracer un cercle plein
Le motif peut être déplacé d'un pixel dans n'importe quelle direction grâce à ShiftLeft(), ShiftRight(), ShiftDown(), ShiftUp(), et plusieurs effets de miroirs peuvent être utilisés afin de dupliquer une partie de l'écran: HorizontalMirror(), VerticalMirror(), QuadrantMirror(), QuadrantRotateMirror(), TriangleTopMirror(), TriangleBottomMirror(), QuadrantTopTriangleMirror(), QuadrantBottomTriangleMirror().

Voici un sketch qui illustre l'utilisation de certaines de ces méthodes.



-
-

À lire également:


Yves Pelletier (Twitter, Facebook)



lundi 1 juin 2020

Mesurer une distance avec le télémètre laser VL53L1X

Le VL53L1X de ST Microelectronics est un capteur qui permet de mesurer la distance d'un obstacle situé à 4 m ou moins au moyen d'un laser (inoffensif pour les yeux) de type VCEL de 940 nm (infrarouge). Pour mes tests, j'ai utilisé un module fabriqué par la compagnie Waveshare, mais Sparksfun et Pololu ont également leur modèle. Plusieurs modules moins chers comportent plutôt le VL53L0X, dont la portée n'est que de 2 m.



Connexion du capteur

Le capteur comporte 6 connecteurs, mais seulement 4 d'entre eux sont nécessaires: 2 pour l'alimentation, et 2 pour la communication I2C.

VCC: à brancher à une tension de 3,3V ou 5 V. Puisque le capteur VL53L1X fonctionne à 2,8 V, tous les modèles de module (breakout) comportent un régulateur de tension permettant de l'utiliser à 3,3 V. Les modules fabriqués par Waveshare et Pololu acceptent les tensions de 5 V, mais pas celui de Sparkfun.

GND: à brancher à GND.

SDA: à brancher à la broche SDA de votre microcontrôleur  (par exemple: A4 pour l'Arduino Uno, PB6 pour la STM32 Blue Pill, GPIO 4 pour l'ESP8266, D21 pour l'ESP32).

SCL: à brancher à la broche SCL de votre microcontrôleur (par exemple: A5 pour l'Arduino Uno, PB7 par la STM32 Blue Pill, GPIO 5 pour l'ESP8266, D22 pour l'ESP32).

SHUT: entrée optionnelle "shutdown control". Je ne l'ai pas utilisée lors de mes tests.

INT: sortie optionnelle "interrupt output". Je ne l'ai pas utilisée lors de mes tests.

Choix et installation d'une bibliothèque Arduino

J'ai installé la bibliothèque VL53L1X conçue par Sparkfun. Il en existe également une conçue par Pololu, que je n'ai pas essayée. Les deux peuvent être installées par l'entremise du gestionnaire de bibliothèque de l'IDE Arduino.

Sketch

Voici un sketch de base qui affiche régulièrement la distance mesurée (en millimètres) dans le moniteur série de l'IDE Arduino. Tout le travail est fait en arrière-plan par les bibliothèques Wire et VL53L1X, le programme est donc très court.

-
-

Si vous constatez que la distance mesurée par le capteur n'est pas tout à fait exacte, vous pouvez la corriger au moyen de la méthode "setOffset" (ligne 23). Dans mon cas, la distance affichée était environ 20 mm plus courte que la distance réelle, et j'ai donc fait setOffset(20) pour ajouter 20 mm au résultat.

Par défaut, le capteur est réglé en mode "longue distance", ce qui permet de mesurer une distance maximale d'environ 4 mètres. La méthode "setDistanceModeShort" (ligne 33) permet de régler le capteur en mode "courte distance". La portée maximale est alors d'environ 2 m, mais les mesures sont moins perturbées par l'éclairage ambiant.

L'angle du champ de vision du capteur est, par défaut, de 27°. Pour certaines applications, ça peut faire en sorte que les mesures sont affectées par la présence d'obstacles indésirables en périphérie. Il est possible de diminuer ce champ de vision en contrôlant la région d'intérêt (ROI: region of interest). Le capteur est constitué d'une matrice de 16 X 16 éléments, et le contrôle de la ROI consiste à n'activer qu'une partie de ces éléments. Le faisceau le plus étroit (qui rendra le capteur sensible uniquement aux objets situés droit devant) est obtenu en utilisant la commande: setROI(4,4,199) (ligne 36) où le premier argument est la largeur de la matrice active (4 est le minimum), le deuxième est la hauteur de la matrice active (4 est, encore une fois, le minimum) et le troisième est le numéro de l'élément situé au centre de la matrice active (voir le fichier "SparkFun_VL53L1X.h" de la bibliothèque pour connaître l'ordre de numérotation (pas très intuitifs) des éléments de la matrice).


Quelques tests

J'ai fait quelques tests en branchant le VL53L1X à un module STM32 Blue Pill mais, comme je le disais plus haut, vous pouvez utiliser une carte Arduino conventionnelle (comme le Uno).



J'ai placé un grand panneau blanc rigide à différentes distances devant le capteur, et j'ai vérifié que la distance mesurée par le VL53L1X était conforme à ce que je mesurais avec un simple ruban à mesurer. Tel que mentionné un peu plus haut, j'ai constaté un écart d'environ 20 mm que j'ai pu compenser dans le sketch grâce à l'instruction setOffset.

J'ai également constaté que, en laissant l'obstacle parfaitement immobile à une distance d'environ 1 mètre, la distance affichée n'était pas toujours identique: elle pouvait facilement varier de presque 10 mm.  Par exemple, la capture d'écran ci-dessous montre que le même obstacle immobile à été mesuré à 1014 mm et à 1022 mm (donc 8 mm d'écart alors que rien de bougeait).



VL53L1X ou HC-SR04?

Puisqu'on peut se payer environ 12 modules à ultrasons HC-SR04 pour le prix d'un seul VL53L1X, on peut se demander en quoi le VL53L1X serait supérieur au HC-SR04. 


J'ai effectué un test consistant à mesurer la distance d'un même obstacle au moyen d'un VL53L1X et d'un HC-SR04.  Pour des distances inférieures à environ 3 mètres, l'écart entre les mesures était inférieur à 5 cm.


J'ai aussi vérifié la stabilité de la mesure de la distance d'un objet immobile à environ 1 mètres, pour constater que le HC-SR04 donnait des mesures étalées sur une plage de 14 mm: un tout petit peu moins stable que le VL53L1X, mais à peine.

Bref, portée similaire et résultats comparables: personnellement, je ne vois rien qui justifierait de payer 12 fois plus cher pour un VL53L1X. 


Yves Pelletier (Twitter, Facebook)


vendredi 29 mai 2020

Micro:Bit - Première exploration avec MakeCode

Depuis le temps que j'en entendais parler, voici enfin l'occasion de faire l'essai du célèbre Micro:Bit. Voyons un peu si cette carte mise au point au Royaume Uni dans le but de faciliter l'apprentissage de la programmation à l'école saura me séduire, même si je ne fais pas tout à fait partie du public cible.



Une première caractéristique qui saute aux yeux, c'est la grande quantité d'éléments utiles présents sur la carte, malgré sa petite taille:
  • Un très respectable microcontrôleur ARM-Cortex M0 32 bits.
  • Une matrice de 25 LEDs (mine de rien, c'est 24 LEDs de plus que la plupart des autres cartes)
  • 2 boutons programmables, en plus du bouton reset
  • Bluethooth (pour communiquer à distance avec un téléphone ou un ordinateur)
  • Accéléromètre
  • Magnétomètre
  • Capteur de température (intégré au microcontrôleur)
  • Capteur de luminosité (ce sont les LEDs, en fait)
Par conséquent, on peut faire beaucoup de choses avec un Micro:Bit sans même y brancher quoi que ce soit.



Bien entendu, le micro:bit comporte aussi des connecteurs qui permettent de lui ajouter des capteurs, moteurs, afficheurs, etc. Sauf que...qui a eu l'idée de ces connecteurs????

Les 5 principaux connecteurs prennent la forme d'un trou jumelé à une surface plane conductrice d'environ 5 mm de largeur. Les trous ont la taille idéale pour y insérer une fiche banane...


...alors que la surface plane a tout juste la bonne largeur pour y installer une pince crocodile...



Sauf que ça ne nous fait que 5 connecteurs: deux pour l'alimentation (3 V et GND) et 3 entrées/sorties programmables. Je veux bien admettre que ces 5 connecteurs offrent certaines possibilités intéressantes, mais ce serait bien utile d'en avoir un peu plus!

Et il y en a, en fait, beaucoup plus: une vingtaine de surfaces conductrices dont l'épaisseur est de l'ordre du millimètre, et séparées d'une distance inférieure à celle qui sépare les trous d'une breadboard. Sauf qu'à moins d'avoir pensé à se procurer un module d'extension (une fente dans laquelle on insère la carte) ou d'utiliser des modules spécialement conçus pour le micro:bit, ces connecteurs sont difficilement utilisables.

Vous désirez brancher au micro:bit un capteur I2C? Il faut utiliser les connecteurs P19 et P20...inaccessibles sans module d'extension. Un capteur SPI? Ce sont alors les connecteurs P13, P14 et P15, également inaccessibles sans module d'extension.

Vous l'aurez deviné: je n'ai pas pensé à me procurer un module d'extension en même temps que mon micro:bit. J'ai une carte qui comporte plus d'une vingtaine d'entrées/sorties, mais je ne peux pour l'instant en utiliser que 5!!! C'est extrêmement frustrant.

Je comprends la pertinence de ces connecteurs dans un contexte scolaire: l'école se procure des périphériques conçus pour le micro:bit et les élèves n'ont qu'à y insérer la carte: c'est rapide, pratique, et ça évite les erreurs de connexions. Mais ça rend le micro:bit moins compatible avec l'écosystème de modules conçus pour les autres microcontrôleurs.

Un peu de programmation avec MakeCode

MakeCode est un environnement de programmation graphique similaire à Scratch ou à MIT App Inventor: puisque nous créons un programme en faisant glisser des briques, il n'est pas nécessaire de mémoriser la syntaxe d'un langage de programmation traditionnel. Remarquez qu'il existe bien d'autres façons de programmer le micro:bit: cet article sur Arduiblog en recense une bonne dizaine.

Je me suis donc dirigé vers makecode.microbit.org et j'ai cliqué sur le bouton "Nouveau projet".



L'écran est essentiellement divisé en trois zones: 
  • La moitié droite est l'endroit où nous construisons le programme. Dès le départ, deux blocs s'y trouvent déjà: "au démarrage" et "toujours".  Nul besoin de consulter la documentation pour deviner que les instructions que nous insérerons dans "au démarrage" s'exécuteront une seule fois, au démarrage du programme, et que celles que nous insérerons dans "toujours" s'exécuteront à répétition pendant toute la durée du programme.

  • Dans la partie centrale: un réservoir de blocs que nous pourrons insérer dans notre programme, en les faisant glisser dans la zone de droite.

  • À gauche: un simulateur qui permet de vérifier le fonctionnement correct de notre programme avant même de le téléverser dans la carte micro:bit. Puisque le téléversement dans la carte prend certain temps, ce simulateur s'est avéré beaucoup plus utile que prévu.

Je me suis amusé à improviser des programmes en navigant au hasard dans la réserve de blocs.

Mon premier programme consistait évidemment à contrôler la matrice de LEDs. Au démarrage,allumer des LEDs de façon à afficher un visage souriant, attendre 2 secondes, puis faire défiler continuellement le message "Eureka!!!".

Après avoir constaté grâce à la simulation que mon programme avait le comportement désiré, j'ai branché mon micro:bit à l'ordinateur (il est apparu comme une clé usb) et j'y ai enregistré le fichier ".hex" généré par MakeCode. La carte a automatiquement exécuté le programme au bout de quelques secondes.

Je bascule en mode JavaScript et je découvre avec plaisir que j'ai produit sans effort un programme en JavaScript assez élégant, malgré mon absence totale de connaissances en JavaScript.


Dans mon deuxième programme, j'ai utilisé les deux boutons. La LED centrale s'allume au démarrage. Le bouton de gauche déplace la LED allumée vers la gauche, alors que celui de droite la déplace vers la droite.


Puis je me suis un peu amusé avec l'accéléromètre: en inclinant la carte, on change la position de la LED qui s'allume...



Conclusion

Ça fonctionne bien, c'est extrêmement facile à programmer sans avoir à installer le moindre logiciel sur l'ordinateur, et ces foutus connecteurs sont tout simplement ridicules!

À lire aussi
Yves Pelletier (Twitter, Facebook)