安装 PlatformIO 并首次烧录 Samovar
Samovar 支持两种完整的安装方式：Arduino IDE 和基于 PlatformIO 的配置器。本页介绍 PlatformIO。使用 Arduino IDE 时，请参阅
“准备 ESP32 以便上传”一节。
配置器可以选择开发板和设备、保存设置、烧录 ESP32、单独上传 LittleFS，以及打开串口监视器。PlatformIO 是一个编译源代码并把它写入开发板的程序。
Windows 10/11（仅限 64 位）：下载
最新的 Samovar 发布版，把压缩包解压到一个简单的路径，例如
C:\Samovar，用能传输数据的 USB 线连接 ESP32，然后双击
flash_windows.bat。该批处理文件会检查 Python 和 PlatformIO，必要时自动安装，然后打开设置窗口。
macOS 和 Linux：在解压后的项目文件夹中打开终端并执行：
chmod +x flash_macos_linux.sh
./flash_macos_linux.sh
该脚本会检查带 Tkinter 的 Python 和 PlatformIO，必要时自动安装，然后打开同一个配置器。
如果 macOS 提示 Operation not permitted 或 getcwd: cannot access parent directories：把项目文件夹从“下载”移到您的个人文件夹，在那里运行脚本。或者在“系统设置 → 隐私与安全性 → 文件和文件夹”中允许终端访问“下载”文件夹，然后彻底重启终端。
在 macOS 上，自动安装 Python 和 Tkinter 需要 Homebrew。在 Linux 上支持 apt、dnf 和 pacman；系统可能会要求输入 sudo 密码——即电脑的管理员密码。
使用配置器：选择 ESP32 DevKit、LILYGO 或 ESP32-S3，设置设备，需要时填写初始的 Wi-Fi 连接信息。其余参数分布在“主要”（«Основные»）、“温度”（«Температуры»）、“调压器”（«Регулятор»）、“BK”（«БК»）、“NBK”（«НБК»）、“传感器”（«Датчики»）、“水泵”（«Насосы»）、“设备”（«Оборудование»）、“步进电机”（«Шаговый двигатель»）、“精馏”（«Ректификация»）、“网络”（«Сеть»）选项卡中——这些就是以前在 Samovar_ini.h 中编辑的那些指令。点击“保存设置”（«Сохранить настройки»），然后点击“烧录”（«Прошить»）。设置保存在项目旁边的文件 user_config_override.h 中，更新源代码时不会被覆盖。编译和烧录日志显示在窗口底部。
对于新开发板，请另外点击“上传 LittleFS”（«Загрузить LittleFS»）。LittleFS 是存放网页界面和用户文件的存储区。重新上传可能会替换程序、Lua 文件和日志，因此配置器会要求确认。重新上传前，请通过 Samovar 的文件编辑器保存您需要的用户文件。
“串口监视器”（«Монитор порта»）按钮打开一个单独的诊断窗口（速率 115200）。如果烧录长时间停在 Connecting...，请按住 BOOT，短按 RESET/EN，开始写入后松开 BOOT。
通过 Wi-Fi 更新。以后的固件更新可以不用数据线。点击“端口或地址”（«Порт или адрес»）字段旁的“刷新”（«Обновить»）：列表中除了 COM 口，还会列出在网络中找到的 Samovar 设备，以及在串口监视器中点击“获取 IP”（«Получить IP»）按钮后设备报告的地址。也可以手动输入地址（例如 192.168.1.37 或 samovar.local）。选择该设备而不是 COM 口，然后点击同样的“烧录”或“上传 LittleFS”。条件：设备上的固件编译时启用了“允许通过 Wi-Fi 更新”（«Разрешить обновление по Wi-Fi»）（“网络”选项卡），电脑与 Samovar 在同一网络中，并且防火墙允许 python.exe 的传入连接。完全擦除闪存、串口监视器以及“重启 ESP”（«Перезагрузить ESP»）只能通过 USB 进行。
“文件编辑器”（«Редактор файлов»）按钮直接在配置器中打开设备上的文件（程序、Lua 脚本、网页界面页面），而“在浏览器中打开”（«Открыть в браузере»）则打开 Samovar 的网页界面。
通过 PlatformIO 手动操作：
pio run -e Samovar -t upload - ESP32 DevKit 或 LILYGO；
pio run -e Samovar_s3 -t upload - ESP32-S3；
pio run -e <environment> -t uploadfs - 上传 LittleFS；
pio run -e <environment> -t monitor - 打开串口监视器。
使用其他调压器的现成环境：Samovar_rmvk（RMVK）、Samovar_sem（SEM_AVR）、Samovar_no_power（无调压器，带 UART）；Samovar_lua - 带 Lua，Samovar_alarm_button - 带紧急按钮。手动编译时的用户参数按 user_config_override.example.h 中的示例写在user_config_override.h 中。
