Für einige Projekte ist es praktisch, Dateien auf einem ESP8266 zu speichern – z.B. weil du Sensordaten sichern möchtest, oder auch die HTML-, CSS- und JavaScript-Dateien eines Webservers sauber ablegen möchtest. Hier kommt das Tool LittleFS ins Spiel, mit dem du das problemlos über die Arduino IDE erledigen kannst.
Ein Hinweis vorab: Es gibt zwei Wege, Dateien mit LittleFS auf deinen ESP8266 zu übertragen. Empfohlen ist das Plugin für die aktuelle Arduino IDE 2.x. Nutzt du noch die ältere IDE 1.8.19, findest du direkt darunter die passende Alternative. Der eigentliche Upload-Ablauf ist danach für beide gleich.
Der aktuelle Weg: das Plugin für die Arduino IDE 2.x
Für die aktuelle Arduino IDE (ab Version 2.2.1) installierst du das Plugin arduino-littlefs-upload von Earle Philhower. Es funktioniert nicht nur mit dem ESP8266, sondern auch mit dem ESP32 und dem Raspberry Pi Pico.
Lade dir zunächst auf der Releases-Seite die aktuelle Datei mit der Endung .vsix herunter (zum Zeitpunkt dieses Tutorials ist das die Version 1.6.3). Kopiere diese Datei anschließend in den Plugin-Ordner deiner Arduino IDE:
- Windows:
C:\Users\<dein Benutzername>\.arduinoIDE\plugins\ - macOS und Linux:
~/.arduinoIDE/plugins/
Den Ordner plugins musst du dabei eventuell selbst anlegen. Starte danach die Arduino IDE neu – fertig. Den eigentlichen Upload startest du später über die Befehlspalette; wie das geht, liest du weiter unten im Abschnitt Dateien auf den ESP8266 hochladen.
Die Alternative: die ältere Arduino IDE 1.8.19
Falls du lieber mit der klassischen Arduino IDE 1.8.19 arbeitest, nutzt du das ältere LittleFS-Plugin. Die Legacy IDE kannst du nach wie vor hier im Bereich Legacy IDE herunterladen.
Das passende Plugin findest du auf GitHub. Aktuell ist das die Version ESP8266LittleFS-2.6.0.zip, die du mit einem Klick auf den Dateinamen herunterladen kannst.
Steuere nun den Ordner deines Sketchbooks an. Das ist der Ort, in dem all deine mit der Arduino IDE erstellten Sketches wiederum in eigenen Ordnern gespeichert werden. Falls du dir nicht sicher bist, findest du den Pfad zum Ordner in den Einstellungen der Arduino IDE:
Erstelle in deinem Sketchbook-Ordner einen neuen Ordner mit dem Namen tools und entpacke dort die LittleFS ZIP-Datei, die du gerade heruntergeladen hast. In deinem Ordner tools sollte nun der entpackte Ordner ESP8266LittleFS zu finden sein.
Wenn du fertig bist, starte die Arduino IDE neu. Öffne nun das Menü Werkzeuge – dort siehst du nun den Eintrag ESP8266 LittleFS Data Upload.
Dateien auf den ESP8266 hochladen
Jetzt, wo alles eingerichtet ist, kann es losgehen. Erstelle einen neuen Sketch und öffne den dazugehörigen Ordner – z.B. über den Menüpunkt Sketch > Sketch-Ordner anzeigen. Erstelle in diesem Ordner nun einen weiteren Ordner namens data.
Alle Dateien, die du später in diesem Ordner ablegst, werden mit dem gerade installierten Tool auf den ESP8266 geladen. Erstelle nun testweise eine einfache Textdatei mit folgendem Inhalt:
Wenn du das hier liest, funktioniert LittleFS. :)Speichere diese Datei nun im Ordner data mit dem Namen test.txt ab. Später wirst du diese Datei in deinem Seriellen Monitor auslesen. Doch zunächst der Upload:
Wähle zunächst (falls noch nicht geschehen) in der Arduino IDE deinen ESP8266 aus. Anschließend kannst du im Menü Werzeuge unter Flash size die benötigte Größe für den Speicher einstellen. Für den folgenden Test musst du hier jedoch nichts umstellen.
Jetzt startest du den Upload – je nachdem, welchen Weg du oben eingerichtet hast:
- Arduino IDE 2.x: Öffne mit Strg + Umschalt + P (am Mac ⌘ + Umschalt + P) die Befehlspalette und wähle den Eintrag „Upload LittleFS to Pico/ESP8266/ESP32″.
- Arduino IDE 1.8.19: Wähle im Menü Werkzeuge den Eintrag ESP8266 LittleFS Data Upload (siehe Bild unten).
Wichtig: Schließe vor dem Upload den Seriellen Monitor, falls er geöffnet ist – sonst ist der Port belegt und die Übertragung schlägt fehl. Nun wird die Datei aus dem Ordner data übertragen, was nach wenigen Sekunden erfolgreich abgeschlossen sein sollte:
Die TXT-Datei anzeigen
Ob der Upload wirklich funktioniert hat, lässt sich natürlich am besten überprüfen, indem du nachschaust, ob du den Inhalt von test.txt auslesen kannst.
Füge hierfür den folgenden Code in deinen Sketch ein:
#include "LittleFS.h"
void setup() {
Serial.begin(115200);
if(!LittleFS.begin()){
Serial.println("An Error has occurred while mounting LittleFS");
return;
}
File file = LittleFS.open("/test.txt", "r");
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() {
}Lade nun den Sketch auf deinen ESP8266 und öffne den Seriellen Monitor. Um die Datei aufzurufen, drücke kurz den Reset-Button RST – nun sollte der Inhalt von test.txt im Seriellen Monitor erscheinen:
In diesem Tutorial hast du die Grundlagen von LittleFS gelernt. Du weißt nun, wo du die Dateien im Sketch-Ordner ablegen musst und wie du diese auf deinen ESP8266 hochlädst.
