Установка Meshtastic на Heltec LoRa 32 V4

Web Flasher (простой способ)

Для большинства пользователей достаточно Web Flasher — прошивка через браузер без командной строки.

1. Открыть flasher.meshtastic.org в Chrome или Edge (другие браузеры не поддерживают Web Serial)
2. Выбрать устройство из списка (Heltec V4)
3. Выбрать версию прошивки (рекомендуется последняя стабильная)
4. Подключить ноду USB-кабелем и следовать инструкциям

Драйвер USB-UART: на macOS обычно не нужен. На Windows может потребоваться CP210x (для Heltec V3) или встроенный USB CDC (Heltec V4, ESP32-S3).

esptool (продвинутый способ)

Требования

• macOS
• Python 3 + pip
• USB-кабель Type-C
• pip3 install esptool

Определение USB-порта

Подключить Heltec V4 по USB:

ls /dev/cu.usbmodem*

Проверить устройство:

esptool --port /dev/cu.usbmodemXXXX chip-id

Должно показать: ESP32-S3, Manufacturer: Espressif.

Скачивание прошивки

Скачать firmware-esp32s3-*.zip из GitHub Releases:

mkdir -p firmware && cd firmware
curl -sL "https://github.com/meshtastic/firmware/releases/latest/download/firmware-esp32s3-<VERSION>.zip" -o firmware-esp32s3.zip
unzip -o firmware-esp32s3.zip -d esp32s3
cd esp32s3

Нужные файлы:

• firmware-heltec-v4-<VERSION>.bin — основная прошивка
• mt-esp32s3-ota.bin — OTA-загрузчик (BLE+WiFi). Для firmware <2.7.19: bleota-s3.bin
• littlefs-heltec-v4-<VERSION>.bin — файловая система

Адреса записи (Heltec V4, 16MB flash, BIGDB_16MB)

Прошивка

Шаг 1: Стереть flash

esptool --port /dev/cu.usbmodemXXXX erase-flash

Шаг 2: Записать firmware

esptool --port /dev/cu.usbmodemXXXX write-flash 0x00 firmware-heltec-v4-<VERSION>.bin

После записи устройство перезагрузится — порт сменит имя (MAC-адрес в имени).

Шаг 3: Download mode для дозаписи

Meshtastic занимает serial-порт. Для дозаписи нужно перевести в download mode:

1. Зажать BOOT (PRG)
2. Нажать RESET (RST)
3. Отпустить RESET
4. Отпустить BOOT

Порт вернётся к оригинальному имени.

Шаг 4: Записать BLE OTA

esptool --port /dev/cu.usbmodemXXXX write-flash 0x650000 mt-esp32s3-ota.bin

Шаг 5: Снова download mode

Повторить комбинацию BOOT + RESET (шаг 3).

Шаг 6: Записать LittleFS

esptool --port /dev/cu.usbmodemXXXX write-flash 0xc90000 littlefs-heltec-v4-<VERSION>.bin

Проверка

pip3 install meshtastic
meshtastic --port /dev/cu.usbmodem<MAC> --info

Должно показать: hwModel: HELTEC_V4, версию прошивки.

Настройка через CLI

meshtastic --port <PORT> --set-owner "MyNode"
meshtastic --port <PORT> --set lora.region RU
meshtastic --port <PORT> --info

Или подключиться через приложение Meshtastic на телефоне по Bluetooth.

Запись всех компонентов за один раз

Можно записать firmware, OTA и LittleFS одной командой в download mode:

esptool --chip esp32s3 --port /dev/cu.usbmodemXXXX write-flash \
  0x00 firmware-heltec-v4-<VER>.bin \
  0x650000 mt-esp32s3-ota.bin \
  0xc90000 littlefs-heltec-v4-<VER>.bin

Это избавляет от необходимости входить в download mode между каждой записью.

Идентификация USB-порта

После erase-flash привычный порт (с MAC в имени) может не появиться. Для идентификации:

system_profiler SPUSBDataType | grep -A 8 "Serial Number"

Искать устройство Espressif с Serial Number, совпадающим с MAC ноды.

Важно

• После erase-flash и записи firmware устройство перезагружается — порт меняет имя
• Для дозаписи bleota и littlefs нужен download mode (BOOT + RESET)
• Heltec V4 — группа BIGDB_16MB, адреса отличаются от V3
• Официальный скрипт установки: device-install.sh в архиве прошивки

См. также

• WiFi OTA обновление Meshtastic — удалённое обновление прошивки по WiFi
• Бэкап и восстановление Meshtastic
• Настройка Meshtastic после прошивки