PlatformIO installieren und Samovar zum ersten Mal flashen

Samovar unterstützt zwei vollwertige Installationswege: die Arduino IDE und den Konfigurator auf Basis von PlatformIO. Diese Seite beschreibt PlatformIO. Für die Arduino IDE nutzen Sie den Abschnitt „ESP32 für das Hochladen vorbereiten“.

Mit dem Konfigurator wählen Sie Platine und Ausstattung, speichern Einstellungen, flashen den ESP32, laden LittleFS separat hoch und öffnen den seriellen Monitor. PlatformIO ist ein Programm, das den Quellcode kompiliert und auf die Platine schreibt.

Windows 10/11 (nur 64 Bit): Laden Sie das neueste Samovar-Release herunter, entpacken Sie das Archiv in einen einfachen Pfad, zum Beispiel C:\Samovar, schließen Sie den ESP32 mit einem datenfähigen USB-Kabel an und doppelklicken Sie auf flash_windows.bat. Die Batch-Datei prüft Python und PlatformIO, installiert sie bei Bedarf und öffnet das Einstellungsfenster.

macOS und Linux: Öffnen Sie das Terminal im entpackten Projektordner und führen Sie aus:
chmod +x flash_macos_linux.sh
./flash_macos_linux.sh
Das Skript prüft Python mit Tkinter und PlatformIO, installiert sie bei Bedarf und öffnet denselben Konfigurator.

Wenn macOS Operation not permitted oder getcwd: cannot access parent directories meldet: Verschieben Sie den Projektordner aus „Downloads“ in Ihren Benutzerordner und starten Sie das Skript dort. Oder erlauben Sie dem Terminal den Zugriff auf den Ordner „Downloads“ unter „Systemeinstellungen → Datenschutz & Sicherheit → Dateien und Ordner“ und starten Sie das Terminal danach vollständig neu.

Unter macOS erfordert die automatische Installation von Python und Tkinter Homebrew. Unter Linux werden apt, dnf und pacman unterstützt; das System fragt eventuell nach dem sudo-Passwort – dem Administratorpasswort des Computers.

Arbeit im Konfigurator: Wählen Sie ESP32 DevKit, LILYGO oder ESP32-S3, legen Sie die Ausstattung und bei Bedarf die anfänglichen WLAN-Zugangsdaten fest. Die übrigen Parameter verteilen sich auf die Registerkarten „Allgemein“ («Основные»), „Temperaturen“ («Температуры»), „Regler“ («Регулятор»), „BK“ («БК»), „NBK“ («НБК»), „Sensoren“ («Датчики»), „Pumpen“ («Насосы»), „Ausstattung“ («Оборудование»), „Schrittmotor“ («Шаговый двигатель»), „Rektifikation“ («Ректификация»), „Netzwerk“ («Сеть») – das sind dieselben Direktiven, die früher in Samovar_ini.h bearbeitet wurden. Drücken Sie „Einstellungen speichern“ («Сохранить настройки»), dann „Flashen“ («Прошить»). Die Einstellungen werden in der Datei user_config_override.h neben dem Projekt gespeichert und beim Aktualisieren der Quellen nicht überschrieben. Das Build- und Flash-Protokoll steht unten im Fenster.

Drücken Sie bei einer neuen Platine zusätzlich „LittleFS hochladen“ («Загрузить LittleFS»). LittleFS ist ein Speicherbereich mit der Weboberfläche und den Benutzerdateien. Erneutes Hochladen kann Programme, Lua-Dateien und Protokolle ersetzen, daher fragt der Konfigurator nach einer Bestätigung. Sichern Sie vor dem erneuten Hochladen die benötigten Benutzerdateien über den Dateieditor von Samovar.

Die Schaltfläche „Serieller Monitor“ («Монитор порта») öffnet ein separates Diagnosefenster (Geschwindigkeit 115200). Bleibt das Flashen lange bei Connecting... hängen, halten Sie BOOT gedrückt, drücken Sie kurz RESET/EN und lassen Sie BOOT los, sobald das Schreiben beginnt.

Aktualisierung über WLAN. Spätere Firmware-Updates sind ohne Kabel möglich. Drücken Sie „Aktualisieren“ («Обновить») neben dem Feld „Port oder Adresse“ («Порт или адрес»): Neben den COM-Ports enthält die Liste die im Netzwerk gefundenen Samovar-Geräte und die Adresse, die das Gerät nach der Schaltfläche „IP abrufen“ («Получить IP») im seriellen Monitor gemeldet hat. Sie können die Adresse auch von Hand eingeben (zum Beispiel 192.168.1.37 oder samovar.local). Wählen Sie das Gerät statt eines COM-Ports und drücken Sie dasselbe „Flashen“ oder „LittleFS hochladen“. Voraussetzungen: Die Firmware auf dem Gerät wurde mit aktivierter Option „Aktualisierung über WLAN erlauben“ («Разрешить обновление по Wi-Fi») gebaut (Registerkarte „Netzwerk“), Computer und Samovar sind im selben Netzwerk, und die Firewall erlaubt eingehende Verbindungen für python.exe. Vollständiges Löschen des Flash-Speichers, der serielle Monitor und „ESP neu starten“ («Перезагрузить ESP») funktionieren nur über USB.

Die Schaltfläche „Dateieditor“ («Редактор файлов») öffnet die Dateien des Geräts (Programme, Lua-Skripte, Seiten der Weboberfläche) direkt im Konfigurator, und „Im Browser öffnen“ («Открыть в браузере») öffnet die Weboberfläche von Samovar.

Manueller Weg über PlatformIO:
pio run -e Samovar -t upload – ESP32 DevKit oder LILYGO;
pio run -e Samovar_s3 -t upload – ESP32-S3;
pio run -e <environment> -t uploadfs – LittleFS hochladen;
pio run -e <environment> -t monitor – seriellen Monitor öffnen.
Fertige Umgebungen mit anderem Regler: Samovar_rmvk (RMVK), Samovar_sem (SEM_AVR), Samovar_no_power (ohne Regler, mit UART); Samovar_lua – mit Lua, Samovar_alarm_button – mit Not-Aus-Taste. Benutzerparameter für einen manuellen Build werden in user_config_override.h nach dem Vorbild von user_config_override.example.h festgelegt.

Fahren Sie nach dem ersten Flashen mit dem Verbinden von Samovar mit dem WLAN fort. Sind die Netzwerkdaten bereits im Konfigurator eingetragen und ist im Speicher der Platine noch kein anderes Netzwerk hinterlegt, versucht die Firmware automatisch, sich damit zu verbinden.