Installer PlatformIO et flasher Samovar pour la première fois

Samovar prend en charge deux méthodes d'installation complètes : l'Arduino IDE et le configurateur basé sur PlatformIO. Cette page décrit PlatformIO. Pour l'Arduino IDE, consultez la section « Préparer l'ESP32 au téléversement ».

Le configurateur permet de choisir la carte et l'équipement, d'enregistrer les réglages, de flasher l'ESP32, de téléverser LittleFS séparément et d'ouvrir le moniteur série. PlatformIO est un programme qui compile le code source et l'écrit sur la carte.

Windows 10/11 (64 bits uniquement) : téléchargez la dernière version de Samovar, décompressez l'archive dans un chemin simple, par exemple C:\Samovar, branchez l'ESP32 avec un câble USB qui transmet les données et double-cliquez sur flash_windows.bat. Le fichier de commandes vérifie Python et PlatformIO, les installe si nécessaire et ouvre la fenêtre de configuration.

macOS et Linux : ouvrez le Terminal dans le dossier décompressé du projet et exécutez :
chmod +x flash_macos_linux.sh
./flash_macos_linux.sh
Le script vérifie Python avec Tkinter et PlatformIO, les installe si nécessaire et ouvre le même configurateur.

Si macOS affiche Operation not permitted ou getcwd: cannot access parent directories : déplacez le dossier du projet de Téléchargements vers votre dossier personnel et lancez-y le script. Ou autorisez l'accès du Terminal au dossier Téléchargements dans « Réglages Système → Confidentialité et sécurité → Fichiers et dossiers », puis redémarrez complètement le Terminal.

Sous macOS, l'installation automatique de Python et de Tkinter nécessite Homebrew. Sous Linux, apt, dnf et pacman sont pris en charge ; le système peut demander le mot de passe sudo - le mot de passe administrateur de l'ordinateur.

Travail dans le configurateur : choisissez ESP32 DevKit, LILYGO ou ESP32-S3, indiquez l'équipement et, si nécessaire, les identifiants Wi-Fi initiaux. Les autres paramètres sont répartis dans les onglets « Principaux » («Основные»), « Températures » («Температуры»), « Régulateur » («Регулятор»), « BK » («БК»), « NBK » («НБК»), « Capteurs » («Датчики»), « Pompes » («Насосы»), « Équipement » («Оборудование»), « Moteur pas à pas » («Шаговый двигатель»), « Rectification » («Ректификация»), « Réseau » («Сеть») - ce sont les mêmes directives que l'on modifiait autrefois dans Samovar_ini.h. Appuyez sur « Enregistrer les réglages » («Сохранить настройки»), puis sur « Flasher » («Прошить»). Les réglages sont enregistrés dans le fichier user_config_override.h à côté du projet et ne sont pas écrasés lors de la mise à jour des sources. Le journal de compilation et de flashage s'affiche en bas de la fenêtre.

Pour une carte neuve, appuyez séparément sur « Téléverser LittleFS » («Загрузить LittleFS»). LittleFS est une zone de mémoire qui contient l'interface web et les fichiers utilisateur. Un nouveau téléversement peut remplacer les programmes, les fichiers Lua et les journaux, c'est pourquoi le configurateur demande une confirmation. Avant de téléverser à nouveau, sauvegardez les fichiers utilisateur dont vous avez besoin via l'éditeur de fichiers de Samovar.

Le bouton « Moniteur série » («Монитор порта») ouvre une fenêtre de diagnostic séparée (vitesse 115200). Si le flashage reste longtemps bloqué sur Connecting..., maintenez BOOT, appuyez brièvement sur RESET/EN et relâchez BOOT une fois l'écriture commencée.

Mise à jour par Wi-Fi. Les mises à jour suivantes du micrologiciel peuvent se faire sans câble. Appuyez sur « Actualiser » («Обновить») à côté du champ « Port ou adresse » («Порт или адрес») : en plus des ports COM, la liste contient les appareils Samovar trouvés sur le réseau et l'adresse que l'appareil a communiquée après le bouton « Obtenir l'IP » («Получить IP») du moniteur série. Vous pouvez aussi saisir l'adresse manuellement (par exemple 192.168.1.37 ou samovar.local). Choisissez l'appareil au lieu d'un port COM et appuyez sur les mêmes boutons « Flasher » ou « Téléverser LittleFS ». Conditions : le micrologiciel de l'appareil est compilé avec l'option « Autoriser la mise à jour par Wi-Fi » («Разрешить обновление по Wi-Fi») activée (onglet « Réseau »), l'ordinateur et Samovar sont sur le même réseau, et le pare-feu autorise les connexions entrantes pour python.exe. L'effacement complet de la mémoire flash, le moniteur série et « Redémarrer l'ESP » («Перезагрузить ESP») ne fonctionnent que par USB.

Le bouton « Éditeur de fichiers » («Редактор файлов») ouvre les fichiers de l'appareil (programmes, scripts Lua, pages de l'interface web) directement dans le configurateur, et « Ouvrir dans le navigateur » («Открыть в браузере») ouvre l'interface web de Samovar.

Méthode manuelle via PlatformIO :
pio run -e Samovar -t upload - ESP32 DevKit ou LILYGO ;
pio run -e Samovar_s3 -t upload - ESP32-S3 ;
pio run -e <environment> -t uploadfs - téléverser LittleFS ;
pio run -e <environment> -t monitor - ouvrir le moniteur série.
Environnements prêts à l'emploi avec un autre régulateur : Samovar_rmvk (RMVK), Samovar_sem (SEM_AVR), Samovar_no_power (sans régulateur, avec UART) ; Samovar_lua - avec Lua, Samovar_alarm_button - avec le bouton d'arrêt d'urgence. Les paramètres utilisateur d'une compilation manuelle se définissent dans user_config_override.h en suivant l'exemple de user_config_override.example.h.

Après le premier flashage, passez à la connexion de Samovar au Wi-Fi. Si les données du réseau sont déjà saisies dans le configurateur et que la mémoire de la carte ne contient pas encore d'autre réseau, le micrologiciel essaie de s'y connecter automatiquement.