dimanche 3 mai 2020

Envoi de données de l'ESP32 / ESP8266 vers Google Sheets

Cet article, initialement publié le 3 mai 2020, a été mis à jour le 21 décembre 2021 pour tenir compte de certains changements dans Google Sheets (il semble maintenant nécessaire d'utiliser l'ancien éditeur de script pour que ça fonctionne).

Dans ce tutoriel, un ESP32 ou un ESP8266 va envoyer des données vers une feuille de calcul Google Sheets. De cette façon, les données pourront s'accumuler sans qu'on ait à  se préoccuper de l'espace mémoire nécessaire, et nous pourrons les consulter à partir de n'importe quel appareil branché à  internet.

J'ai constaté que la plupart des tutos disponibles sur le web préconisent l'utilisation d'un site web intermédiaire comme par exemple IFTTT ou Temboo, en prétextant que ça simplifie les choses, surtout en ce qui concerne l'établissement d'une connexion sécurisée.

J'admets que c'est un tout petit peu plus compliqué, mais j'ai préféré utiliser une méthode sans intermédiaire: notre microcontrôleur enverra une requête "GET" qui sera traitée par un "Google app script" lié à notre feuille Google Sheet. Étant totalement néophyte dans l'art d'écrire ce genre de script (basé sur le langage javascript), j'ai utilisé, comme point de départ, cet article du blog Electrosome.

Créer une feuille Google Sheets

J'imagine qu'il n'est pas nécessaire que j'insiste outre mesure sur la nécessité d'être détenteur d'un compte Google pour réussir ce tuto... Nous allons donc sur le site de Google Sheets afin de créer une nouvelle feuille de calcul.  Vous lui donnez le nom que vous voulez et vous pouvez, si vous le désirez, écrire le nom de chaque colonne sur la première ligne


Puisque certaines des données envoyées par l'ESP seront des nombres comportant un point décimal, je dois régler ma feuille pour qu'elle utilise le point plutôt que la virgule (menu Fichier, "Paramètres").



Dans mon cas, j'ai remplacé le réglage par défaut "Canada (français)", basé sur la virgule, à "Canada (anglais)", basé sur le point. Bien entendu, ce réglage n'est pas nécessaire si votre ESP n'envoie que des nombres entiers.



Création d'un App Script

Nous allons maintenant créer le script qui gérera les messages émis par l'ESP:  menu Extensions / Apps Script .

Votre navigateur va alors ouvrir un script vide sur le site "script.google.com".  À cette étape, il est très important de cliquer sur le lien "Utiliser l'ancien éditeur" situé en haut à droite de la fenêtre.





Vous donnez à votre projet le nom que vous voulez, et vous copiez le code situé ci-dessous.



Voici le script complet:

-
-

Ce script comporte deux fonctions:  doGet reçoit les requêtes GET émises par l'ESP et lui retourne un message pour indiquer que tout a bien fonctionné, et add_data ajoute dans la feuille de calcul les nouvelles données reçues à l'intérieur de la requête GET.

Attention: vous devez modifier l'URL de la feuille de calcul sur la première ligne de la fonction add_data: il faut y placer l'URL de la feuille de calcul que nous venons de créer.

De plus, pour l'affichage de la date et de l'heure, j'ai utilisé "America/Montreal". Si vous habitez en France, vous préférerez probablement remplacer ça par "Europe/Paris".

Déploiement du script en application web

Nous allons maintenant faire en sorte que ce script soit accessible à partir du web: il s'agit du menu Publier - Déployer en tant qu'application Web...


À la question "Who has access to the app", nous sélectionnons "Anyone, even anonymous".


À partir de là, Google panique un peu et vous demande de confirmer que vous accordez à ce script non-vérifié la permission de jouer dans vos fichiers.










Finalement, une dernière boîte de dialogue vous fournit l'URL de notre application web: il est important de la copier, car nous en aurons besoin dans le sketch de l'ESP32 / ESP8266.


Notez que chaque fois que vous apporterez une modification à votre script, il sera nécessaire de le "redéployer" en tant qu'application web, en prenant bien soin de régler "Project version" à "Nouveau". Sinon, c'est l'ancienne version non-modifiée qui continuera de s'exécuter.

Test du script

Si vous le désirez, vous pouvez immédiatement vérifier le fonctionnement correct de votre script directement dans le navigateur web en ajoutant 
"?func=addData&val1=10&val2=20" à la fin de l'URL de votre script.

Ça devrait avoir pour effet d'ajouter une ligne à votre feuille de calcul.



Programmation de l'ESP32 ou de l'ESP8266

Il ne nous reste plus qu'à programmer notre ESP32 ou notre ESP8266. Pour ce faire, nous utilisons l'IDE Arduino et vous pouvez, au besoin, vous référez des précédentes publications pour voir comment procéder: ESP32 ou ESP8266.

Puisque le présent tutoriel porte sur la communication avec Google Sheets et non sur l'utilisation d'un capteur en particulier, j'ai choisi de transmettre deux valeurs obtenues au moyen d'une équation mathématique. Bien entendu, dans une application réelle, il serait plus pertinent de transmettre une ou plusieurs valeurs mesurées au moyen de capteurs branchés à l'ESP (température, luminosité, etc.).  Ces valeurs sont calculées aux lignes 68 et 69, puis intégrées à l'URL de notre requête GET sous les noms de val1 et val2 (ligne 72).

Ici encore, vous devrez modifier certaines informations dans le sketch avant de pouvoir l'utiliser:

  • le nom et le mot de passe de votre réseau Wi-Fi (lignes 17 et 18)
  • l'URL de votre application web (ligne 72)
  • si vous utilisez un ESP8266: le fingerprint SHA1 de votre app script (ligne 24)

Pour récupérer ce fingerprint SHA1, allez sur la page de votre feuille de calcul ou de votre script avec un navigateur web, cliquez sur le cadenas à gauche de l'URL, et visionnez le certificat de sécurité de google.com. Copiez les octets correspondant au fingerprint SHA1 et copiez-le dans votre sketch.





---

---

Résultat

Pendant l'exécution du sketch, toutes les 10 secondes, une nouvelle ligne s'ajoute dans la feuille de calcul.


À lire aussi:

Pour consigner des événements qui ne se destinent pas à un traitement mathématique, vous préférerez peut-être écrire dans un document Google Docs avec l'ESP32 ou l'ESP8266. Vous serez peut-être intéressés à consulter la liste des projets impliquant l'ESP32 ou l'ESP8266.

Yves Pelletier (Twitter, Facebook)



samedi 25 avril 2020

Aficher sur un écran ST7735 les fichiers d'une carte SD (STM32)

Mon petit écran couleur ST7735 128*160 pixels est muni d'un lecteur pour carte SD, que je ne m'étais jamais donné la peine d'utiliser jusqu'à tout récemment.

Dans ce tuto, je branche l'écran ST7735 et son lecteur de carte SD à un module STM32F103C8T6 "Blue Pill" et, en le programmant avec l'IDE Arduino, j'affiche à l'écran du texte et des images qui avaient préalablement été enregistrés sur une carte SD.



Tout ceci pourrait être fait sans problème avec une carte Arduino Uno, mais ça m'a semblé intéressant d'utiliser la Blue Pill, puisqu'elle est plutôt rapide et son niveau logique de 3,3 V est parfaitement adapté à l'écran et au lecteur de cartes.

Connexions de l'écran au module Blue Pill

Le lecteur de cartes SD et l'écran communiquent tous les deux en SPI et, pour cette raison, ils partagent la même broche SCLK (A5) et la même broche MOSI (A7) (le lecteur de cartes est le seul des deux périphériques à utiliser la broche MISO).

Si votre écran ST7735 ne comporte pas de lecteur de carte SD intégré, vous pouvez obtenir les mêmes résultats avec un lecteur de carte SD distinct.
  • Broche 1 GND de l'écran - Broche G de la Blue Pill
  • Broche 2 VCC de l'écran - 5 V de la Blue Pill
  • Broches 3, 4, et 5 NC de l'écran - pas branchées
  • Broche 6 RESET de l'écran - Broche A3 de la Blue Pill
  • Broche 7 AO de l'écran - Broche A2 de la Blue Pill
  • Broche 8 SDA de l'écran - Broche A7 de la Blue Pill
  • Broche 9 SCL de l'écran - Broche A5 de la Blue Pill
  • Broche 10 CS de l'écran - Broche A8 de la Blue Pill
  • Broche 11 SCK de l'écran (SD) - Broche A5 de la Blue Pill
  • Broche 12 MISO de l'écran (SD) - Broche A6 de la Blue Pill
  • Broche 13 MOSI de l'écran (SD) - Broche A7 de la Blue Pill
  • Broche 14 SD_CS de l'écran (SD) - Broche A4 de la Blue Pill
  • Broche 15 LED+ de l'écran - Broche 3.3 de la Blue Pill
  • Broche 16 LED- de l'écran - Broche G de la Blue Pill


Préparation de l'IDE Arduino pour la programmation d'un STM32

Puisque nous allons programmer la Blue Pill avec l'IDE Arduino, c'est important que le logiciel ait été configuré pour la programmation des cartes STM32. Tout est expliqué dans cet article.

Installation des bibliothèques GFX et ST7735 d'Adafruit

La bibliothèque SD est déjà disponible, par défaut, dans l'IDE Arduino, mais nous avons également besoin de la bibliothèque GFX et de la bibliothèque ST7735, toutes deux mises au point par Adafruit. Elles peuvent toutes les deux s'installer par l'entremise du gestionnaire de bibliothèque.

Sketch #1: affichage de texte stocké sur la carte SD

Dans ce premier exemple, l'écran affiche successivement toutes les lignes d'un texte enregistré sous forme de fichier sur la carte SD.

Le fichier s'intitule "mots.txt" et doit avoir préalablement été enregistré sur la carte SD. Pour cette démonstration, j'ai écrit dans ce fichier quelques proverbes. La raison pour laquelle vous pouvez voir plusieurs espaces entre certains mots, c'est que l'écran affichera 13 caractères par ligne. Si le 13e caractère se trouve au milieu d'un mot, le mot sera séparé en deux parties lors de l'affichage à l'écran, ce qui ne fait pas très joli.


Lors de l'exécution du programme, l'écran affiche successivement chaque ligne du fichier txt pendant 5 secondes. Notre Blue Pill s'est transformée en philosophe un peu casse-pieds!


-
-


Sketch #2: Affichage à l'écran d'images .bmp stockées sur la carte SD

Dans ce deuxième exemple, des images se trouvant sur la carte SD sous la forme de fichiers .bmp sont affichées à l'écran, l'une après l'autre.  Dans ce cas, j'ai utilisé, avec assez peu de modifications, un sketch mis au point par Adafruit.


Les images doivent être enregistrées sur la carte SD sous la forme de fichiers bitmap (.bmp) ayant la même résolution que l'écran (donc 160 pixels de large par 128 pixels de haut, dans mon cas).

L'image ne sera pas redimensionnée: si elle est plus grande que l'écran, seule une portion de l'image sera affichée, en taille réelle!

-

-

À lire aussi

Yves Pelletier (Twitter, Facebook)

dimanche 19 avril 2020

Robot suiveur de ligne, version Arduino


Il y a quelques jours, je vous ai proposé la réalisation d'un robot suiveur de ligne basé sur un Raspberry Pi.

Le robot que je vous présente aujourd'hui se comporte de la même façon: grâce à une paire de photorésistances, il peut faire la différence entre une surface claire et une surface sombre, ce qui lui permet de se déplacer en suivant fidèlement une ligne sinueuse sur le plancher­.

La version que je vous présente aujourd'hui a pour cerveau une carte Arduino Uno.




Mise au point du capteur

Le principe de fonctionnement du capteur est le suivant: une LED éclaire la surface du plancher, et une photorésistance capte la lumière réfléchie par le plancher. Si la surface éclairée est blanche, la quantité de lumière réfléchie est plus grande que si la surface est noire. La résistance de la photorésistance ne sera donc pas la même si celle-ci se trouve au-dessus d'une surface blanche ou d'une surface blanche.

Le capteur est donc constitué de deux LEDs blanches, situées de part et d'autre de la ligne qui sera suivie par le robot, et de deux photorésistances, également situées de part et d'autre de la ligne.



Les LEDs seront alimentées par une sortie 5 V de la carte Arduino. Avec une résistance de protection de 120 Ω, on obtient une bonne intensité lumineuse sans risquer de dépasser le courant maximal.

Chaque photorésistance est branchée en série avec une résistance fixe de façon à former un diviseur de tension.  Pour déterminer la valeur optimale de la résistance fixe (celle qui provoquera le plus grand écart de tension entre la surface blanche et la surface noire), mesurez la résistance de la photorésistance lorsque la LED éclaire la surface blanche (Rmin) ainsi que sa résistance lorsque la LED éclaire la surface noire (Rmax).

La valeur optimale de la résistance fixe se calcule ensuite de cette façon:

Rfixe = (Rmin + Rmax )1/2

Chacun des deux diviseurs de tension constitués d'une photorésistance et d'une résistance fixe est alimentée par la sortie 5 V de l'Arduino.

Le signal du capteur de gauche est acheminé à l'entrée analogique A0 de l'Arduino, alors que celui du capteur de droite est branché à l'entrée A1.

Ce double capteur doit être installé à l'avant du véhicule robotisé de façon à éclairer le plancher. Vous obtiendrez de meilleurs résultats en plaçant un petit écran opaque entre la LED et la photorésistance, afin que cette dernière reçoive uniquement la lumière réfléchie par le plancher (et non celle qui provient directement de la LED).





Branchement des moteurs

Le véhicule robotisé est constitué de deux roues motrices, chacune d'entre elles étant actionnée par un moteur à courant continu.  Il est très important que ces moteurs comportent une boîte d'engrenage pour diminuer leur vitesse de rotation: un moteur à courant continu directement relié à la roue, sans boîte d'engrenage, produirait un bolide beaucoup trop nerveux pour suivre la ligne.



Comme intermédiaire entre la carte Arduino et les moteurs, j'ai utilisé un module L298N. D'autres options auraient fait l'affaire, surtout que je n'ai pas besoin de mettre les moteurs en marche arrière dans ce projet (mais c'était pratique d'utiliser le même matériel et les mêmes connexions que pour mon robot préprogrammé et mon robot éviteur d'obstacles).


Le module L298N est branché de la façon suivante:

  • Sorties OUT1 et OUT2 du L298N: premier moteur
  • Sorties OUT3 et OUT4 du L298N: deuxième moteur
  • Entrées +12 V et GND du L298N: alimentation des moteurs
  • Broche ENA du L298N: broche 9 de l'Arduino
  • Broche IN1 du L298N: broche 3 de l'Arduino
  • Broche IN2 du L298N: broche 4 de l'Arduino
  • Broche IN3 du L298N: broche 5 de l'Arduino
  • Broche IN4 de L298N: broche 6 de l'Arduino
  • Broche ENB du L298N: broche 10 de l'Arduino
L'alimentation des moteurs (adaptée aux caractéristiques de vos moteurs, donc pas nécessairement 12 V) n'est pas la même que l'alimentation de l'Arduino (qui était, dans mon cas, une alimentation USB portative de 5 V).


Sketch

Au démarrage du programme, le robot doit être correctement positionné, avec un capteur de chaque côté de la ligne. Deux secondes après le démarrage du programme, la valeur initiale de chaque capteur est mise en mémoire.

On fait ensuite avancer le robot en comparant périodiquement l'état de chaque capteur à sa valeur initiale. Si la valeur mesurée par un capteur est significativement différente de la valeur initiale, on suppose qu'il se trouve au-dessus de la ligne et on le fait tourner pour éviter qu'il ne la traverse.

Il sera peut-être nécessaire de modifier la valeur des variables globales  "sensibilite" et "vitesse".

-
-

À lire aussi



Yves Pelletier (Twitter, Facebook)