Dans ce guide, vous apprendrez à télécharger des fichiers sur le système de fichiers ESP32 (LittleFS) en utilisant un plugin pour Arduino IDE (1.8.X). LittleFS est un système de fichiers léger créé pour les microcontrôleurs qui vous permet d’accéder à la mémoire flash comme vous le feriez dans un système de fichiers standard sur votre ordinateur, mais plus simple et plus limité. Le plugin que nous allons installer vous permet d’utiliser trois systèmes de fichiers différents : LittleFS, SPIFFS ou FatFS.
Pour le moment, cette méthode n’est pas compatible avec Arduino 2.0. Donc, vous devriez utiliser la version 1.8.X de l’IDE Arduino.
Si vous souhaitez utiliser LittleFS avec l’ESP8266, lisez : Installez ESP8266 NodeMCU LittleFS Filesystem Uploader dans l’IDE Arduino.
Table des matières
Présentation de LittleFS
LittleFS est un système de fichiers léger créé pour les microcontrôleurs qui vous permet d’accéder à la mémoire flash comme vous le feriez dans un système de fichiers standard sur votre ordinateur, mais c’est plus simple et plus limité. Vous pouvez lire, écrire, fermer et supprimer des fichiers. L’utilisation d’un système de fichiers avec les cartes ESP32 est particulièrement utile pour :
Installation du téléchargeur de système de fichiers Arduino ESP32
Actuellement, il existe un plugin pour l’IDE Arduino (version 1.8.X) qui vous permet de compresser et de télécharger des fichiers vers l’image du système de fichiers SPIFFS, LittleFS ou FatFS dans le système de fichiers ESP32.
Remarque : dans la plupart de nos projets, nous utilisons SPIFFS pour le système de fichiers ESP32. Il est toujours compatible avec l’ESP32 et vous pouvez utiliser SPIFFS sans aucun problème. Cependant, actuellement, de nombreuses bibliothèques migrent vers LittleFS.
Le plugin que nous allons installer est à la fois compatible avec SPIFFS et LittleFS. C’est donc un avantage par rapport à l’ancien plugin et vous pouvez toujours utiliser SPIFFS.
Il y a quelques avantages à utiliser LittleFS plutôt que SPIFFS :
- LittleFS est optimisé pour une faible utilisation des ressources et utilise un algorithme de nivellement d’usure qui répartit uniformément les écritures sur la mémoire flash, prolongeant ainsi sa durée de vie.
- LittleFS fournit des temps de montage et un accès aux fichiers plus rapides en utilisant une structure d’indexation de répertoires.
- LittleFS minimise le risque de corruption des données lors de coupures de courant ou de pannes système.
- LittleFS est en cours de développement actif.
Instructions Windows
Suivez les étapes suivantes pour installer l’uploader du système de fichiers si vous utilisez Windows :
1) Allez à la page des versions et cliquez sur le dernier fichier esp32fs.zip à télécharger.
2) Décompressez le fichier téléchargé. Vous devriez avoir un dossier appelé esp32fs avec un fichier appelé esp32fs.jar à l’intérieur.
3) Trouvez votre emplacement Sketchbook. Dans votre IDE Arduino, accédez à Fichier> Préférences et vérifiez l’emplacement de votre carnet de croquis. Dans mon cas, c’est dans le chemin suivant : C:\Users\sarin\Documents\Arduino.
3) Accédez à l’emplacement du carnet de croquis et créez un dossier d’outils si vous ne l’avez pas déjà (assurez-vous que l’application Arduino IDE est fermée).
4) Dans le dossier des outils, créez un autre dossier appelé ESP32FS si vous ne l’avez pas déjà fait.
5) Dans le dossier ESP32FS, créez un dossier appelé tool.
6) Copiez le fichier esp32fs.jar dans le dossier de l’outil (si vous avez déjà un fichier esp32fs.jar d’un plugin précédent, supprimez-le et remplacez-le par le nouveau). Ainsi, la structure du répertoire ressemblera à ceci :
<home_dir>/Arduino/tools/ESP32FS/tool/esp32fs.jar
7) Maintenant, vous pouvez ouvrir l’IDE Arduino.
Pour vérifier si le plugin a été installé avec succès, ouvrez votre IDE Arduino et sélectionnez votre carte ESP32. Dans le menu Outils, vérifiez que vous avez bien l’option « ESP32 Sketch Data Upload ». Cliquez sur cette option. Une fenêtre apparaîtra pour vous permettre de choisir le système de fichiers que vous souhaitez utiliser.
Comme vous pouvez le voir, vous avez la possibilité de choisir entre LittleFS, SPIFFS ou FatFS et vous pouvez même avoir la possibilité d’effacer le flash si nécessaire.
Toutes nos félicitations! Vous avez installé avec succès le plugin Filesystem Uploader pour l’ESP32 sur l’IDE Arduino.
Instructions Mac OS X
Suivez les instructions suivantes si vous utilisez MacOS X.
1) Allez à la page des versions et cliquez sur le dernier fichier esp32fs.zip à télécharger.
2) Décompressez les fichiers. Vous devriez avoir un dossier appelé esp32fs avec un fichier appelé esp32fs.jar à l’intérieur.
3) Créez un dossier appelé tools dans /Documents/Arduino/ si vous ne l’avez pas déjà fait.
4) Dans le dossier des outils, créez-en un autre appelé ESP32FS.
5) Dans le dossier ESP32FS, créez un dossier appelé tool. Ainsi, la structure du répertoire ressemblera à ceci :
<home_dir>/Arduino/tools/ESP32FS/tool/
6) Copiez le fichier esp32fs.jar décompressé dans le répertoire de l’outil (si vous avez déjà un fichier esp32fs.jar d’un plugin précédent, supprimez-le et remplacez-le par le nouveau). Vous devriez avoir une structure de dossiers similaire.
7) Maintenant, vous pouvez ouvrir l’IDE Arduino.
Pour vérifier si le plugin a été installé avec succès, ouvrez votre IDE Arduino et sélectionnez votre carte ESP32. Dans le menu Outils, vérifiez que vous avez bien l’option « ESP32 Sketch Data Upload ».
Cliquez sur cette option. Une fenêtre apparaîtra pour vous permettre de choisir le système de fichiers que vous souhaitez utiliser.
Comme vous pouvez le voir, vous avez la possibilité de choisir entre LittleFS, SPIFFS ou FatFS et vous pouvez même avoir la possibilité d’effacer le flash si nécessaire.
Toutes nos félicitations! Vous avez installé avec succès le plugin Filesystem Uploader pour l’ESP32 sur l’IDE Arduino.
Téléchargement de fichiers à l’aide de Filesystem Uploader
Pour télécharger des fichiers sur le système de fichiers ESP32 LittleFS, suivez les instructions suivantes.
1) Créez un croquis Arduino et enregistrez-le. À des fins de démonstration, vous pouvez enregistrer une esquisse vide.
2) Ensuite, ouvrez le dossier de croquis. Vous pouvez aller à Esquisse > Afficher le dossier Esquisse. Le dossier dans lequel votre croquis est enregistré devrait s’ouvrir.
3) Dans ce dossier, créez un nouveau dossier appelé data.
4) À l’intérieur du dossier de données, vous devez placer les fichiers que vous souhaitez enregistrer dans le système de fichiers ESP32. Par exemple, créez un fichier .txt avec du texte appelé test_example.
5) Ensuite, pour télécharger les fichiers, dans l’IDE Arduino, il vous suffit d’aller dans Outils> ESP32 Sketch Data Upload.
6. Sélectionnez l’option LittleFS et cliquez sur OK.
Assurez-vous que le moniteur série est fermé avant de télécharger les fichiers, sinon vous obtiendrez une erreur liée à la communication série et les fichiers ne seront pas téléchargés.
Le téléchargeur écrasera tout ce que vous avez déjà enregistré dans le système de fichiers.
Remarque : sur certaines cartes de développement ESP32, vous devez appuyer sur le bouton BOOT intégré pendant environ deux secondes pour télécharger les fichiers.
Les fichiers ont été téléchargés avec succès sur le système de fichiers ESP32 lorsque vous voyez le message « LittleFS Image Uploaded ».
Test du plugin Filesystem Uploader
Maintenant, vérifions simplement si le fichier a bien été enregistré dans le système de fichiers ESP32. Téléchargez simplement le code suivant sur votre carte ESP32.
/*********
Rui Santos
Complete project details at https://Raspberryme.com/esp32-littlefs-arduino-ide/
*********/
#include "LittleFS.h"
void setup() {
Serial.begin(115200);
if(!LittleFS.begin()){
Serial.println("An Error has occurred while mounting SPIFFS");
return;
}
File file = LittleFS.open("/test_example.txt");
if(!file){
Serial.println("Failed to open file for reading");
return;
}
Serial.println("File Content:");
while(file.available()){
Serial.write(file.read());
}
file.close();
}
void loop() {
}
Après le téléchargement, ouvrez le moniteur série à un débit en bauds de 115200. Appuyez sur le bouton ESP32 « ENABLE/RST ». Il devrait imprimer le contenu de votre fichier .txt sur le moniteur série.
Vous avez téléchargé avec succès des fichiers sur le système de fichiers ESP32 à l’aide du plug-in.
Conclusion
Dans ce tutoriel, vous avez installé un plugin pour l’IDE Arduino qui vous permet de télécharger des fichiers sur le système de fichiers ESP32. Ce plugin prend en charge trois systèmes de fichiers différents : SPIFFS, LittleFS et FatFS.
Alors que de nombreuses bibliothèques et projets migrent vers LittleFS, SPIFSS est toujours utilisé et vos projets précédents qui utilisent SPIFFS devraient toujours fonctionner.
Étant donné que ce nouveau plugin prend en charge à la fois SPIFFS et LittleFS, vous devriez envisager d’installer celui-ci à la place du plugin SPIFFS afin d’avoir plus de flexibilité dans le choix du système de fichiers.
Nous espérons que vous avez trouvé ce tutoriel utile.
En savoir plus sur l’ESP32 en utilisant nos ressources :
Cette vidéo vous emmène dans l’histoire de Raspberry Pi :
