Установка PlatformIO и первая прошивка Самовара

Samovar поддерживает два полноценных способа установки: Arduino IDE и конфигуратор на основе PlatformIO. На этой странице описан PlatformIO. Для Arduino IDE используйте раздел «Подготовка ESP32 к загрузке».

Конфигуратор позволяет выбрать плату и оборудование, сохранить настройки, прошить ESP32, отдельно загрузить LittleFS и открыть монитор порта. PlatformIO — программа, которая собирает исходный код и записывает его в плату.

Windows 10/11 (только 64-разрядная): скачайте последний выпуск Samovar, распакуйте архив в простой путь, например C:\Samovar, подключите ESP32 USB-кабелем с передачей данных и дважды щёлкните flash_windows.bat. Батник проверит Python и PlatformIO, при необходимости установит их и откроет окно настройки.

macOS и Linux: откройте Terminal в распакованной папке проекта и выполните:
chmod +x flash_macos_linux.sh
./flash_macos_linux.sh
Скрипт проверит Python с Tkinter и PlatformIO, при необходимости установит их и откроет тот же конфигуратор.

Если macOS сообщает Operation not permitted или getcwd: cannot access parent directories: перенесите папку проекта из Downloads в домашнюю папку и запустите скрипт там. Либо разрешите Terminal доступ к папке «Загрузки» в «Системные настройки → Конфиденциальность и безопасность → Файлы и папки», затем полностью перезапустите Terminal.

В macOS для автоматической установки Python и Tkinter нужен Homebrew. В Linux поддерживаются apt, dnf и pacman; система может запросить пароль sudo — пароль администратора компьютера.

Работа в конфигураторе: выберите ESP32 DevKit, LILYGO или ESP32-S3, задайте оборудование и при необходимости исходные данные Wi-Fi. Остальные параметры разложены по вкладкам «Основные», «Температуры», «Регулятор», «БК», «НБК», «Датчики», «Насосы», «Оборудование», «Шаговый двигатель», «Ректификация», «Сеть» — это те же директивы, что раньше правили в Samovar_ini.h. Нажмите «Сохранить настройки», затем «Прошить». Настройки сохраняются в файл user_config_override.h рядом с проектом, при обновлении исходников он не затирается. Журнал сборки и прошивки находится в нижней части окна.

Для новой платы отдельно нажмите «Загрузить LittleFS». LittleFS — область памяти с веб-интерфейсом и пользовательскими файлами. Повторная загрузка может заменить программы, Lua-файлы и журналы, поэтому конфигуратор запрашивает подтверждение. Перед повторной загрузкой сохраните нужные пользовательские файлы через файловый редактор Самовара.

Кнопка «Монитор порта» открывает отдельное окно диагностики (скорость 115200). Если прошивка долго стоит на Connecting..., удерживайте BOOT, коротко нажмите RESET/EN и отпустите BOOT после начала записи.

Обновление по Wi-Fi. Последующие прошивки можно ставить без кабеля. Нажмите «Обновить» рядом с полем «Порт или адрес»: кроме COM-портов в список попадают устройства Samovar, найденные в сети, и адрес, который устройство сообщило после кнопки «Получить IP» в мониторе порта. Адрес можно ввести и вручную (например 192.168.1.37 или samovar.local). Выберите устройство вместо COM-порта и нажмите те же «Прошить» или «Загрузить LittleFS». Условия: прошивка на устройстве собрана с включённым «Разрешить обновление по Wi-Fi» (вкладка «Сеть»), компьютер и Самовар в одной сети, брандмауэр разрешает python.exe входящие подключения. Полная очистка флеша, монитор порта и «Перезагрузить ESP» работают только по USB.

Кнопка «Редактор файлов» открывает файлы устройства (программы, Lua-скрипты, страницы web-интерфейса) прямо в конфигураторе, «Открыть в браузере» — web-интерфейс Самовара.

Ручной способ через PlatformIO:
pio run -e Samovar -t upload — ESP32 DevKit или LILYGO;
pio run -e Samovar_s3 -t upload — ESP32-S3;
pio run -e <окружение> -t uploadfs — загрузить LittleFS;
pio run -e <окружение> -t monitor — открыть монитор порта.
Готовые окружения с другим регулятором: Samovar_rmvk (РМВ-К), Samovar_sem (SEM_AVR), Samovar_no_power (без регулятора с UART); Samovar_lua — с Lua, Samovar_alarm_button — с аварийной кнопкой. Пользовательские параметры для ручной сборки задаются в user_config_override.h по образцу user_config_override.example.h.

После первой прошивки перейдите к подключению Самовара к Wi-Fi. Если данные сети уже заданы в конфигураторе и в памяти платы ещё нет другой сети, прошивка попробует подключиться к ним автоматически.