Instalar PlatformIO y flashear Samovar por primera vez

Samovar admite dos métodos completos de instalación: Arduino IDE y el configurador basado en PlatformIO. Esta página describe PlatformIO. Para Arduino IDE, consulte la sección «Preparar el ESP32 para la carga».

El configurador permite elegir la placa y el equipamiento, guardar los ajustes, flashear el ESP32, cargar LittleFS por separado y abrir el monitor serie. PlatformIO es un programa que compila el código fuente y lo graba en la placa.

Windows 10/11 (solo 64 bits): descargue la última versión de Samovar, descomprima el archivo en una ruta sencilla, por ejemplo C:\Samovar, conecte el ESP32 con un cable USB que transmita datos y haga doble clic en flash_windows.bat. El archivo por lotes comprueba Python y PlatformIO, los instala si hace falta y abre la ventana de configuración.

macOS y Linux: abra Terminal en la carpeta descomprimida del proyecto y ejecute:
chmod +x flash_macos_linux.sh
./flash_macos_linux.sh
El script comprueba Python con Tkinter y PlatformIO, los instala si hace falta y abre el mismo configurador.

Si macOS muestra Operation not permitted o getcwd: cannot access parent directories: mueva la carpeta del proyecto de Descargas a su carpeta personal y ejecute allí el script. O permita a Terminal el acceso a la carpeta Descargas en «Ajustes del Sistema → Privacidad y seguridad → Archivos y carpetas» y reinicie Terminal por completo.

En macOS, la instalación automática de Python y Tkinter requiere Homebrew. En Linux se admiten apt, dnf y pacman; el sistema puede pedir la contraseña de sudo, es decir, la contraseña de administrador del ordenador.

Trabajo en el configurador: elija ESP32 DevKit, LILYGO o ESP32-S3, indique el equipamiento y, si hace falta, los datos iniciales de Wi-Fi. Los demás parámetros están repartidos en las pestañas «Generales» («Основные»), «Temperaturas» («Температуры»), «Regulador» («Регулятор»), «BK» («БК»), «NBK» («НБК»), «Sensores» («Датчики»), «Bombas» («Насосы»), «Equipamiento» («Оборудование»), «Motor paso a paso» («Шаговый двигатель»), «Rectificación» («Ректификация»), «Red» («Сеть»): son las mismas directivas que antes se editaban en Samovar_ini.h. Pulse «Guardar ajustes» («Сохранить настройки») y después «Flashear» («Прошить»). Los ajustes se guardan en el archivo user_config_override.h junto al proyecto y no se sobrescriben al actualizar las fuentes. El registro de compilación y flasheo está en la parte inferior de la ventana.

Para una placa nueva, pulse por separado «Cargar LittleFS» («Загрузить LittleFS»). LittleFS es un área de memoria que contiene la interfaz web y los archivos del usuario. Volver a cargarla puede sustituir programas, archivos Lua y registros, por eso el configurador pide confirmación. Antes de volver a cargarla, guarde los archivos de usuario que necesite mediante el editor de archivos de Samovar.

El botón «Monitor serie» («Монитор порта») abre una ventana de diagnóstico aparte (velocidad 115200). Si el flasheo se queda mucho tiempo en Connecting..., mantenga pulsado BOOT, pulse brevemente RESET/EN y suelte BOOT cuando empiece la escritura.

Actualización por Wi-Fi. Las siguientes actualizaciones del firmware pueden hacerse sin cable. Pulse «Actualizar» («Обновить») junto al campo «Puerto o dirección» («Порт или адрес»): además de los puertos COM, la lista incluye los dispositivos Samovar encontrados en la red y la dirección que comunicó el dispositivo tras pulsar el botón «Obtener IP» («Получить IP») en el monitor serie. También puede introducir la dirección a mano (por ejemplo 192.168.1.37 o samovar.local). Seleccione el dispositivo en lugar de un puerto COM y pulse el mismo «Flashear» o «Cargar LittleFS». Condiciones: el firmware del dispositivo está compilado con la opción «Permitir actualización por Wi-Fi» («Разрешить обновление по Wi-Fi») activada (pestaña «Red»), el ordenador y Samovar están en la misma red y el cortafuegos permite conexiones entrantes para python.exe. El borrado completo de la memoria flash, el monitor serie y «Reiniciar ESP» («Перезагрузить ESP») solo funcionan por USB.

El botón «Editor de archivos» («Редактор файлов») abre los archivos del dispositivo (programas, scripts Lua, páginas de la interfaz web) directamente en el configurador, y «Abrir en el navegador» («Открыть в браузере») abre la interfaz web de Samovar.

Método manual con PlatformIO:
pio run -e Samovar -t upload - ESP32 DevKit o LILYGO;
pio run -e Samovar_s3 -t upload - ESP32-S3;
pio run -e <environment> -t uploadfs - cargar LittleFS;
pio run -e <environment> -t monitor - abrir el monitor serie.
Entornos preparados con otro regulador: Samovar_rmvk (RMVK), Samovar_sem (SEM_AVR), Samovar_no_power (sin regulador, con UART); Samovar_lua - con Lua, Samovar_alarm_button - con el botón de emergencia. Los parámetros de usuario para una compilación manual se indican en user_config_override.h siguiendo el ejemplo de user_config_override.example.h.

Tras el primer flasheo, pase a conectar Samovar a la Wi-Fi. Si los datos de red ya están indicados en el configurador y la memoria de la placa todavía no contiene otra red, el firmware intenta conectarse a ella automáticamente.