Mettre les données dans la mémoire flash de l’ESP

Bonjour et bienvenue à notre contribution d’aujourd’hui.

Les modules ESP sont très populaires. Nous avons montré dans le passé combien il est facile de se connecter au Wi-Fi, afficher des sites Web, et passer des relais.

Cependant, une fonction très utile est de mettre des données dans la mémoire flash de l’ESP. Cela vous permet de télécharger des fichiers auxquels nous pouvons accéder plus tard avec notre croquis. Ou pour stocker des informations qui sont encore disponibles après un redémarrage.

Télécharger des fichiers sur ESP

Nous avons besoin de l’outil "ESP8266FS" - une extension qui s’intègre dans l’IDE Arduino. Il ajoute l’entrée "ESP8266 Sketch Data Upload" dans le menu Tools. 

Tout d’abord, nous téléchargeons l’outil à partir de la page ESP8266 GitHub:

https://github.com/esp8266/arduino-esp8266fs-plugin/releases/download/0.1.3/ESP8266FS-0.1.3.zip

Créons un dossier nommé "outils" dans le même dossier que nos croquis Arduino. Normalement, il est situé sous "C:-Users"-lt;username -gt;-Documents-Arduino".

Décompressez le fichier .zip téléchargé et copiez le dossier ESP8266FS à l’annuaire des "outils". À la fin, nous aurons "C:-Users" -lt;username-gt;-Documents-Arduino-tools-ESP8266FS-tool-esp8266fs.jar".

Maintenant, nous allons redémarrer l’IDE Arduino et faire un nouveau croquis. J’appelle cet exemple "ESP Data Test". Nous devons maintenant enregistrer ce croquis.

Nous allons maintenant naviguer vers le dossier nouvellement créé "C:-Users" -lt;Username-gt;-Documents-Arduino-ESP-Data-Test" et de créer le dossier "données" là-bas. Tous les fichiers stockés ici seront téléchargés sur la mémoire flash de l’ESP dès que nous effectuerons le téléchargement. 

Je crée un nouveau fichier texte appelé test.txt, j’écris une paire de lignes de texte dedans et je l’enregistre dans le nouveau dossier "data".

J’utilise un ESP8266-01S avec adaptateur USB, donc j’ai défini les options suivantes sous Outils:

• Conseil d’administration: "Generic ESP8266 Module"
• Flash Taille: "1M (64K SPIFFS)
• Vitesse de téléchargement: "115200" 
• Port: "COMx" - sélectionnez votre port COM

Si vous ne connaissez pas la taille de la mémoire de votre module, il ya un conseil à la fin de l’article sur la façon de le déterminer. 

Comme un test, nous essayons maintenant de charger l’esquisse vide (seulement la configuration vide () et la boucle vide()) à l’ESP. Pour mon ESP, je dois m’assurer que le mode de programmation est activé.

Si tout cela a fonctionné, nous pouvons essayer de charger le contenu du dossier "données" sur l’ESP. Pour cela, nous allons à "Tools" -gt; "ESP8266 Sketch Data Upload".

"SPIFFS Uploading Image..." apparaît dans l’IDE ... et après un court laps de temps apparaît: "SPIFFS Image téléchargée":

Si une erreur se produit à ce stade ("SPIFFS Upload échoué!"), c’est probablement parce que l’ESP n’est plus en mode de programmation. Déconnectez et reconnectez simplement la connexion USB, en veillant à ce que le mode de programmation soit activé.

Utilisez SPIFFS dans Sketch 

Afin d’utiliser SPIFFS dans le croquis, nous incluons la bibliothèque FS.h:

#include "FS.h"

Maintenant, nous avons les commandes suivantes:

Objet De système de fichiers (SPIFFS)

SPIFFS.begin ()

Monte le système de fichiers SPIFFS. Doit toujours être exécuté avant toutes les autres commandes. Retourne vrai si la monture a fonctionné, sinon "faux".

SPIFFS.format ()

Formats (supprime) le système de fichiers. Rendements vrais si le formatage a été un succès.

SPIFFS.open (chemin, mode)

Ouvre un fichier. En tant que « chemin », ils spécifient le nom du fichier, y compris le chemin absolu (p. ex. «/nom de dossier/test.txt »). "mode" indique le type d’accès. Peut inclure les options suivantes : "r", "w", "a", "r", "w", "a".

• "r" ouvre le fichier pour la lecture. Le fichier doit exister
• "w" Crée un nouveau fichier sans contenu. Si un fichier du même nom existe, son contenu est supprimé et le fichier est considéré comme un nouveau fichier vierge.
• "a" Annexe des données au fichier ("appendice"). Les données sont jointes à la fin du fichier. Si le fichier n’existe pas, un nouveau est créé.
• "r" ouvre un fichier pour la lecture et l’écriture. Le fichier doit exister.
• "w" Crée un fichier vide pour la lecture et l’écriture.
• "a" ouvre un fichier à lire, ainsi qu’à joindre.

SPIFFS.exists (chemin)

Retourne "vrai" si le chemin existe, sinon "faux".

SPIFFS.openDir (chemin)

Ouvre le répertoire spécifié. Retourne un objet "dir".

SPIFFS.remove (chemin)

Supprime le chemin spécifié. Retourne un "vrai" si la suppression a été réussie.

SPIFFS.rename (pathFrom, pathTo)

Rebaptise un fichier de "pathDe" à "PathTo". Le chemin doit être absolu. Retourne un vrai si le changement de nom a été un succès.

Structure d’information de système de fichiers

fs_info FSInfo;
SPIFFS.info (fs_info);

Remplit la structure FSInfo d’informations sur le système de fichiers. Retourne un "vrai" sur le succès, sinon un "faux".

Structure:

Struct FSInfo
size_t totaloctets;
size_t utiliséBytes;
size_t blockSize;
size_t pageSize;
size_t maxOpenFiles;
size_t maxPathLength;
};

Objet d’annuaire (Dir)

L’objet "Dir" nous permet d’aborder les fichiers dans un répertoire en utilisant les méthodes "next()", "filename()" et "openFile(mode)".

Dir dir - SPIFFS.openDir ("/données");
tandis que (dir.next())
Serial.print (dir.fileName);
Fichier f - dir.openFile ("r");
Serial.println (f.size);
}

dir.next() est "vrai" tant qu’il trouve des fichiers dans l’annuaire. Il doit être appelé avant "fileName" ou "openFile".

"openFile" prend l’argument "mode", qui est le même que spiFFS.open.

Objet de fichier (fichier) 

SPIFFS.open et dir.openFile retournent un objet "fichier". Il s’agit d’un objet de flux et prend en charge toutes les fonctions telles que readbytes, findUntil, parseInt, println, et toutes les autres méthodes de flux.

Cependant, il ya aussi certains qui sont spécifiques à l’objet de fichier (fichier).

file.seek (offset, mode)

Fonctionne comme la fonction fseek en C. La position actuelle change comme suit, selon la valeur du « mode » :

• SeekSet -gt; Position est définie pour "compenser" octets dès le début
• SeekCur - position actuelle est déplacée par "offset" octets
• SeekEnd -gt; Position est définie pour "compenser" octets à partir de la fin du fichier

file.position()

Reflète la position actuelle dans le fichier comme une valeur dans les octets

fichier.size()

Retourne la taille du fichier dans les octets.

file.name();

Renvoie le nom du fichier sous le nom de « const char ». Peut être stocké dans une chaîne à l’aide de "Nom de chaîne file.name);".

file.close()

Ferme le fichier.

Étude de cas

Maintenant, nous écrivons un petit croquis pour tester le tout: nous voulons sortir notre fichier texte "test.txt" que nous avons créé au début et rempli de quelques lignes de texte sur le moniteur de série.

#include "FS.h" Ici, nous intégrons la bibliothèque requise

Vide Configuration() {   Série.Commencer(9600); Activer la sortie en série   Retard(1000); Courte pause afin que nous ayons le temps d’ouvrir le Serial Monitor.      SPIFFS SPIFFS.Commencer(); Montage de système de fichiers   Fichier Q = SPIFFS SPIFFS.Ouvert( "/test.txt", "r"); Fichier ouvert pour la lecture   Si (!Q) {     Série.println("fichier ouvert échoué");   }   String Données = Q.Lirestring(); Lecture du contenu du fichier texte...   Série.println("Contenu du fichier ouvert:");   Série.println(Données); // ... et réédité   Q.Proche(); Nous fermons le fichier
}
Vide Boucle() {
}

Après le téléchargement, la sortie apparaîtra sur le moniteur de série :

Astuce Bonus: Quelle est la taille de la mémoire flash de mon ESP 8266?

Selon le module ESP8266 que vous utilisez, la taille de la mémoire flash peut varier. Bien que vous puissiez rechercher la feuille de données à l’aide de l’étiquette sur la puce, pour être sûr qu’il ya un petit croquis qui vérifie la taille, la vitesse et le mode de votre module. Le Croquis est disponible sur https://github.com/esp8266/Arduino/tree/master/libraries/esp8266/examples/CheckFlashConfig

Il suffit de télécharger cette esquisse et de définir le moniteur de série à 115200 baud, nous verrons la taille de la puce.

J’espère que vous avez aimé notre blog aujourd’hui et a encouragé votre créativité. Dorénavant, vous pouvez utiliser la fonction SPIFFS de votre ESP pour stocker par exemple des modules texte HTML, pour stocker les données des capteurs en permanence, et bien plus encore.

Nous sommes très heureux de louanges, de critiques et de suggestions pour notre blog.

Le vôtre Markus Neumann