PDF herunterladen
        SAMOVAR 
×
Menü
Suche
 
   
   
   
 
  Benutzerhandbuch    

Sketch aktualisieren

Samovar 7.00: Die Aktualisierung über die Arduino IDE wird unterstützt. Gleichwertig können Sie den Konfigurator der neuen Version starten und auf „Flashen“ («Прошить») drücken; LittleFS wird mit einer separaten Schaltfläche „LittleFS hochladen“ («Загрузить LittleFS») hochgeladen und ersetzt die Dateien der Weboberfläche (eigene Dateien in LittleFS können dabei verloren gehen). Der Konfigurator speichert Ihre Werte in der Datei user_config_override.h neben dem Sketch – kopieren Sie sie in das Verzeichnis der neuen Version, dann bleiben die Einstellungen erhalten. Sie können auch über WLAN flashen: Die Schaltfläche „Aktualisieren“ («Обновить») findet Samovar im Netzwerk, wenn im Abschnitt „Netzwerk“ («Сеть») die Option „Aktualisierung über WLAN erlauben“ («Разрешить обновление по Wi-Fi») aktiviert ist (USE_UPDATE_OTA).
 
 
Mit dem Erscheinen neuer Versionen wird eine Aktualisierung notwendig. Eine neue Version kann neue oder geänderte  Bibliotheken und Werkzeuge mitbringen. Um Fehler zu vermeiden, wird daher empfohlen, jedes Mal genau die Bibliotheken und Werkzeuge zu verwenden, die im Archiv  der jeweiligen Version enthalten sind.
 
Achtung! Wichtig!
Ab Version 6.0 wird die Oberfläche, sofern Samovar mit dem Internet verbunden ist,  automatisch passend zur jeweiligen Sketch-Version aktualisiert, d. h. wenn Sie zu einer älteren Sketch-Version zurückkehren müssen, kehrt auch die Oberfläche zur entsprechenden Version zurück. Ohne Internetverbindung müssen Sie die Oberfläche selbst lokal installieren.
 
 
Sketch aktualisieren
 
Im Abschnitt Erstes Hochladen des Sketches haben wir eine bestimmte Struktur von Dateien und Verzeichnissen in  ...Documents\Arduino angelegt. Wir bauen auf dieser bisherigen Ordnung auf.
 
Bereiten Sie das Verzeichnis ... Documents\Arduino\ in folgender Reihenfolge vor:
 
So bleibt im Verzeichnis ... Documents\Arduino\ nur das Verzeichnis OLD übrig.
Und in OLD befinden sich: das Archiv Samovar-7.00 und das Verzeichnis Samovar-7.00 mit dem darin liegenden Verzeichnis Samovar.
Diese Ablage schließt Fehler beim Aktualisieren aus, ermöglicht es, die bisherigen Einstellungen für die neue Version zu übernehmen und bei Bedarf schnell zur vorherigen oder einer noch älteren  Version zurückzukehren.
 
Danach gehen wir Schritt für Schritt wie bei der Erstinstallation vor: Wir „entpacken“ die neue Version in  ... Documents\Arduino\, bis die bisherige Verzeichnisstruktur entstanden ist. Entsprechend tragen das Archiv und das daraus entpackte Verzeichnis die neue Versionsnummer im Namen.
Jetzt laden wir den Sketch aber nicht sofort auf den ESP hoch, sondern nehmen zuerst die nötigen Einstellungen in der Datei Samovar_ini.h vor. Dafür gibt es zwei Wege:
 
1. Der richtige Weg.
Bequem geht das mit speziellen Programmen, die zwei verschiedene Dateien vergleichen und die Unterschiede zwischen ihnen anschaulich anzeigen.
Empfohlen wird das Programm WinMerge — (ein Vergleichs- und Zusammenführungswerkzeug für Windows, das sowohl Dateien als auch Ordner vergleichen kann und die Unterschiede übersichtlich in Textform anzeigt . Das Programm ist einfach zu bedienen und hat eine russische Oberfläche.)
Oder das leistungsfähigere, aber auch schwerer zu erlernende  Programm  Notepad++ mit dem installierten Plugin Compare.
 
Ein Beispiel mit  dem Programm WinMerge.
Zum Vergleichen müssen Sie zwei verschiedene Dateien Samovar_ini.h auswählen
Wählen Sie zuerst die Datei aus dem Verzeichnis OLD, in das wir gerade die vorherige Samovar-Version verschoben haben. Sie liegt unter: ... \Documents\Arduino\OLD\Samovar-7.00\Samovar\
Die zweite Datei nehmen Sie aus dem Verzeichnis mit der neuen Samovar-Version. Sie liegt in ... \Documents\Arduino\Samovar\
 
Das Programm vergleicht beide Dateien und hebt die Zeilen mit Unterschieden hervor.
 
Die Unterschiede werden in einem helleren Farbton hervorgehoben. Sie können die Werte rechts von Hand bearbeiten oder den Cursor links setzen und den Befehl „Nach rechts kopieren“ («Копировать направо») ausführen.
So wird die Einstellungsdatei Zeile für Zeile an Ihre Ausrüstung angepasst. Wenn alle Änderungen erledigt sind, klicken Sie auf das Symbol „Speichern“
Verwechseln Sie vor allem nicht: Links ist die alte Einstellungsdatei, rechts die Datei, mit der Samovar arbeiten wird.
 
2. Der schnelle Weg
Vergleichen Sie bei der Aktualisierung über die Arduino IDE die Samovar_ini.h der neuen und der vorherigen Version und übernehmen Sie nur Ihre eigenen Werte. Kopieren Sie die alte Samovar_ini.h nicht über die neue: Auch eine kleine Version kann neue Pflichtparameter enthalten.
Wenn die neue Version neue Samovar-Funktionen bringt, müssen Sie die Datei Samovar_ini.h bearbeiten, sonst sind die neuen Funktionen nicht verfügbar und Samovar arbeitet nicht korrekt.
Wenn die Einstellungen im Konfigurator vorgenommen wurden, müssen Sie Samovar_ini.h nicht bearbeiten: Ihre Werte stehen in user_config_override.h, die Samovar_ini.h überschreibt. Es genügt, diese Datei in die neue Version zu übernehmen.
 
Die Einrichtung ist abgeschlossen. Sie können den Sketch auf den ESP hochladen. Da es sich um eine Aktualisierung eines bereits installierten Sketches handelt, müssen Sie die WLAN-Verbindung nicht erneut einrichten und die Standardeinstellungen nicht laden.
Beim Aktualisieren können Sie bereits darauf verzichten, den ESP an den USB-Anschluss  anzuschließen, und die Firmware „drahtlos“ (OTA) aktualisieren
 
 
 
„Zurückrollen“ auf eine alte Version.
 
Etwas an der neuen Version gefällt Ihnen nicht, oder sie arbeitet nicht korrekt. Sie möchten zu den vorherigen Versionen zurückkehren. Mit dieser Ablage alter Versionen ist das ganz einfach.
Bereiten Sie das Verzeichnis ... \Documents\Arduino wie für eine Aktualisierung vor:
Verschieben Sie aus dem Verzeichnis Samovar per Ziehen (oder Ausschneiden und Einfügen)  eine Ebene höher, nach ... \Documents\Arduino\,  die beiden Verzeichnisse libraries  und tools.

Das ist alles. Sie können den Sketch auf den ESP hochladen.
Später, beim Aktualisieren auf eine neue Version, müssen Sie nur das Verzeichnis ... \Documents\Arduino  leeren, indem Sie Samovar, libraries  und tools löschen. Sie müssen sie nicht nach OLD verschieben, da sie dort bereits liegen und wir eine Kopie verwendet haben.
 
Beim Aktualisieren des Sketches können Sie bereits  die Arduino IDE in den Versionen  2.x.x verwenden. Diese Versionen haben jedoch keinen Menüpunkt „ESP32 LittleFS Data Upload“, und ohne das Plugin können Sie die Oberfläche nicht lokal aktualisieren. Dementsprechend wird die Weboberfläche nicht aktualisiert, wenn Samovar keinen Internetzugang hat.
 
Nachtrag. In den Versionen Arduino IDE 2.x.x ist es möglich geworden, die Oberfläche mit einem Plugin lokal zu installieren. Die Anleitung finden Sie hier. Das Plugin (arduino-littlefs-upload-1.1.7.vsix) liegt im Samovar-Archiv im Verzeichnis tools\ESP32LittleFS_Arduino IDE 2.X, siehe Erstes Hochladen des Sketches.
 
Sie können mehrere  Versionen der Arduino IDE 2.x.x und Arduino IDE 1.x.x gleichzeitig auf Ihrem Computer installieren, sie stören sich gegenseitig nicht.  So können Sie Arduino IDE 2.x weiterhin als Haupt-IDE verwenden und  Arduino IDE 1.x nur dann, wenn Sie das Dateisystem LittleFS (einschließlich der Oberfläche) lokal auf Ihren ESP32 hochladen müssen.
 
Wenn Sie verschiedene Versionen der Arduino IDE verwenden, müssen Sie sie in verschiedene Verzeichnisse installieren. Dazu genügt es, die Versionsnummer an den Verzeichnisnamen anzuhängen.
Zum Beispiel.
C:\Program Files(x86)\Arduino1_1_18;
C:\Program Files\Arduino IDE_2_3_2;
C:\Program Files\Arduino IDE_2_3_1
 So können Sie in jeder Version der Arduino IDE unterschiedliche Versionen des ESP32 SDK von Espressif Systems verwenden.
Beachten Sie jedoch, dass jede der verwendeten Arduino-IDE-Versionen, separat für ESP32 eingerichtet werden muss.
 
Achtung!
Wenn Sie das ESP32-Add-on „ESP32 by Espressif Systems“ in Version  3.0.0 oder höher verwenden, schaltet die Firmware die Aktualisierung über WLAN (OTA) selbst ab: Der Parameter USE_UPDATE_OTA wirkt in diesem Core nicht, hochladen nur über USB. Außerdem müssen Sie den verwendeten Platinentyp ändern und die richtigen Partitionen wählen. Die Samovar-Partitionstabelle fehlt in Core 3.x; sie wird von Hand hinzugefügt (die Beschreibung steht am Anfang der Datei Samovar.ino):
  1. Kopieren Sie die Datei partitions\samovar.csv aus dem Sketch-Verzeichnis nach ...\Arduino15\packages\esp32\hardware\esp32\3.x.x\tools\partitions\ (unter Windows liegt das Verzeichnis Arduino15 in C:\Users\<name>\AppData\Local\);
  2. fügen Sie der Datei ...\esp32\3.x.x\boards.txt drei Zeilen hinzu:
    esp32.menu.PartitionScheme.samovar=Samovar
    esp32.menu.PartitionScheme.samovar.build.partitions=samovar
    esp32.menu.PartitionScheme.samovar.upload.maximum_size=1507328
  3. starten Sie die Arduino IDE neu und wählen Sie „Tools“ → „Partition Scheme“ → „Samovar“.
Der PlatformIO-Konfigurator verwendet Core 2.0.17 und dieselbe Partitionstabelle (partitions/samovar.csv); hier muss nichts hinzugefügt werden.
Beitrag im Forum.
 
Fragen und Antworten. FAQ
 
Ich habe nirgends gefunden, wie man die Firmware „drahtlos“ (OTA) aktualisiert. Bitte um einen Tipp...
Beim ersten Mal müssen Sie in jedem Fall per Kabel flashen  und Samovar mit Ihrem WLAN verbinden. In Samovar_ini.h muss der Parameter USE_UPDATE_OTA aktiviert sein (standardmäßig aktiviert; im Konfigurator heißt er „Aktualisierung über WLAN erlauben“ («Разрешить обновление по Wi-Fi»)), der ESP32-Core muss 2.0.17 sein.
Starten Sie Samovar und die Arduino IDE neu. Danach erscheint die IP-Adresse von Samovar unter den Netzwerkports  der Arduino IDE (ein Netzwerkport mit dem Namen samovar).
Wählen Sie statt des USB-Ports (COM) die IP-Adresse, dann läuft die Aktualisierung drahtlos.
 
 
Wenn Sie Samovar später  per USB-Kabel mit dem Computer verbinden, stehen unter den Ports zwei Möglichkeiten zur Verfügung: Aktualisierung „drahtlos“ oder über den COM-Port. Über den gewählten Kanal wird der Sketch dann übertragen.
Der Konfigurator funktioniert genauso: Drücken Sie „Aktualisieren“ («Обновить»), dann erscheinen in der Portliste sowohl der COM-Port als auch der im Netzwerk gefundene Samovar; wählen Sie den Netzwerkport und drücken Sie „Flashen“ («Прошить»). Die Schaltfläche „LittleFS hochladen“ («Загрузить LittleFS») funktioniert ebenfalls über das Netzwerk.