ESP32 Flasher

Простой прошивальщик для ESP32-устройств на базе Python/PySide6. Автоматически загружает актуальную прошивку с GitHub Releases.

Требования

• Windows 10/11 x64
• Интернет-соединение (прошивка тянется с GitHub при каждом запуске)
• USB-драйвер платы (CH340 / CP2102 / FTDI)

Использование

1. Запустить atomspectra-waterfall-esp32-flasher-X.Y.Z.exe (скачать с Releases)
2. Выбрать проект из выпадающего списка
3. Выбрать версию прошивки (по умолчанию — последний релиз; можно откатиться на более раннюю)
4. Выбрать COM-порт платы
5. Для AtomSpectra (водопад) — опционально указать IP платы и оставить включённым «Перезагрузить плату по сети перед прошивкой»: плата успеет корректно закрыть открытый сегмент водопада до аппаратного сброса esptool. У остальных проектов этого шага нет.
6. Нажать «Установить»

Flasher автоматически загрузит выбранную версию прошивки с GitHub и прошьёт плату.

⚠ Перед использованием

Flasher стирает и перезаписывает флэш-память выбранной платы ESP32. Убедитесь, что:

• выбран правильный COM-порт именно вашей платы (посторонние USB-UART-устройства — звуковые карты, адаптеры — прошивать нельзя, это выведет их из строя);
• прошивка не прерывается (не отключайте плату во время записи) — прерывание может потребовать восстановления платы в режиме загрузчика.

Flasher прошивает только плату ESP32; на подключённый к плате измерительный прибор он не воздействует.

Отказ от ответственности

Программа предоставляется «как есть», без каких-либо гарантий. Автор не несёт ответственности за любой прямой или косвенный ущерб: неработоспособность платы или подключённого оборудования, потерю данных, ошибочную прошивку не того устройства. Используя программу, вы действуете на свой страх и риск.

Поддерживаемые устройства

Проект	Репо прошивки
AtomSpectra (водопад ESP32-S3)	VibeEngineering-LLC/atomspectra-waterfall-esp32
AtomFast BLE Gateway (ESP32)	VibeEngineering-LLC/atomfast-esp32
Radex BLE Gateway (ESP32-S3 N16R8)	VibeEngineering-LLC/radex-esp32
RadonEye BLE Gateway (ESP32)	VibeEngineering-LLC/radoneye-esp32
ATOMTEX БДКГ-05 USB Gateway (ESP32-S3)	VibeEngineering-LLC/atomtex-esp32

Прошивка Radex-шлюза настраивается уже после заливки и требует платы N16R8 (16 МБ флеша, 8 МБ PSRAM): образ идёт без пароля Wi-Fi и без MAC прибора. Плата поднимает свою точку доступа, сеть выбирается с телефона, а прибор Radex находится в эфире сам. Порядок шагов программа печатает после успешной прошивки.

Обновление прошивки

Flasher при каждом запуске запрашивает latest release с GitHub API и кэширует файлы в %LOCALAPPDATA%\atomspectra-flasher\cache\<repo>\<tag>\. Для принудительного обновления нажать «Обновить прошивку» в UI.

При отсутствии интернета или превышении rate limit GitHub API — flasher показывает fatal-сообщение. Offline-режим не поддерживается.

Сборка из исходников

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
python scripts/make_icon.py       # если ассетов ещё нет
python -m flasher                 # запуск без сборки .exe

Сборка .exe:

python -m PyInstaller --noconfirm --clean atomspectra-waterfall-esp32-flasher.spec
# → dist/atomspectra-waterfall-esp32-flasher-X.Y.Z.exe (версия — из flasher/__init__.py)

Лицензия

MIT