Files
MeshCore-Posadmesh/RELEASE.md
T
shade c86ae584ab
Build and deploy Docs site to GitHub Pages / github-pages (push) Canceled after 0s
PR Build Check / build (Heltec_v3_companion_radio_ble) (push) Canceled after 0s
PR Build Check / build (Heltec_v3_repeater) (push) Canceled after 0s
PR Build Check / build (Heltec_v3_room_server) (push) Canceled after 0s
PR Build Check / build (LilyGo_Tlora_C6_repeater_) (push) Canceled after 0s
PR Build Check / build (PicoW_repeater) (push) Canceled after 0s
PR Build Check / build (RAK_4631_companion_radio_ble) (push) Canceled after 0s
PR Build Check / build (RAK_4631_companion_radio_ethernet) (push) Canceled after 0s
PR Build Check / build (RAK_4631_repeater) (push) Canceled after 0s
PR Build Check / build (RAK_4631_repeater_ethernet) (push) Canceled after 0s
PR Build Check / build (RAK_4631_room_server) (push) Canceled after 0s
PR Build Check / build (RAK_4631_room_server_ethernet) (push) Canceled after 0s
PR Build Check / build (Tbeam_SX1276_repeater) (push) Canceled after 0s
PR Build Check / build (wio-e5-mini_repeater) (push) Canceled after 0s
PR Build Check / build (wio_wm1110_repeater) (push) Canceled after 0s
Run Unit Tests / test (push) Canceled after 0s
refactor: rebrand to PosadMesh, translate docs to Russian, drop legacy brokers
2026-10-07 19:04:39 +03:00

5.2 KiB
Raw Blame History

Выпуск прошивок

Репозиторий живёт на https://git.meshinfo.ru/shade/MeshCore-Posadmesh. Автоматической сборки релизов в CI нет: прошивки собираются локально через posadmesh-build.sh, а теги и релизы создаются вручную в веб-интерфейсе git.meshinfo.ru.

Версии сборки

  • FIRMWARE_VERSION — версия upstream MeshCore, на которой основана сборка (например v1.15.0)
  • POSADMESH_VERSION — версия релиза PosadMesh (например v2026.5.1)

Обе задаются переменными окружения перед запуском сборки:

export FIRMWARE_VERSION=v1.15.0
export POSADMESH_VERSION=v2026.5.1
bash posadmesh-build.sh build-firmware heltec_v4_repeater_observer

Теги релизов PosadMesh

Один или несколько тегов следующих форматов помечают релиз соответствующего трека:

  • companion-wifi-v1.15.0
  • repeater-bridge-espnow-v1.15.0
  • observer-posadmesh-bridge-espnow-v2026.5.1
  • observer-posadmesh-bridge-mqtt-v2026.7.0
  • observer-posadmesh-v2026.5.1

В companion-wifi-v1.15.0 используется версия upstream MeshCore. В repeater-bridge-espnow-v1.15.0 используется версия upstream MeshCore. В observer-posadmesh-bridge-espnow-v2026.5.1 используется версия релиза PosadMesh. В observer-posadmesh-bridge-mqtt-v2026.7.0 используется версия релиза PosadMesh. В observer-posadmesh-v2026.5.1 используется версия релиза PosadMesh.

Соответствие тегов и треков:

  • companion-wifi-v* — прошивка companion WiFi
  • repeater-bridge-espnow-v* — прошивка ESP-NOW-моста репитера
  • observer-posadmesh-bridge-espnow-v* — прошивка обсервера с ESP-NOW
  • observer-posadmesh-bridge-mqtt-v* — прошивка обсервера с MQTT-мостом
  • observer-posadmesh-v* — прошивка обсервера

Сборка выполняется локально для нужного таргета; тегов на одном коммите может быть несколько.

Итоговая версия прошивки

  • companion-wifi использует версию из тега как FIRMWARE_VERSION
  • repeater-bridge-espnow использует версию из тега как FIRMWARE_VERSION
  • observer-posadmesh-bridge-espnow использует FIRMWARE_VERSION upstream MeshCore, а версию PosadMesh из тега — как POSADMESH_VERSION
  • observer-posadmesh-bridge-mqtt использует FIRMWARE_VERSION upstream MeshCore, а версию PosadMesh из тега — как POSADMESH_VERSION
  • observer-posadmesh использует FIRMWARE_VERSION upstream MeshCore, а версию PosadMesh из тега — как POSADMESH_VERSION

Итоговая строка версии зависит от трека:

  • companion-wifi: v1.15.0-<commit>
  • repeater-bridge-espnow: v1.15.0-<commit>
  • observer-posadmesh-bridge-espnow: v1.15.0-posadmesh-v2026.5.1-<commit>
  • observer-posadmesh-bridge-mqtt: v1.15.0-posadmesh-v2026.7.0-<commit>
  • observer-posadmesh: v1.15.0-posadmesh-v2026.5.1-<commit>

Пример:

  • тег: observer-posadmesh-v2026.5.1
  • переменные: FIRMWARE_VERSION=v1.15.0, POSADMESH_VERSION=v2026.5.1
  • итоговая версия сборки: v1.15.0-posadmesh-v2026.5.1-abcdef

Типичный порядок выпуска

  1. Обновите release-notes.yml в ветке develop — добавьте записи о релизе, которые должны войти в помечаемый тегом коммит.
  2. Откройте и смерджите релизный PR из develop в main.
  3. Соберите нужные прошивки локально с подходящими FIRMWARE_VERSION и POSADMESH_VERSION.
  4. Создайте нужные теги релиза на целевом коммите в main.
  5. Запушьте теги в git.meshinfo.ru.
  6. Создайте релиз в веб-интерфейсе git.meshinfo.ru и приложите собранные файлы из out/.

Если release-notes.yml должен отражать помеченный тегом релиз прошивки в репозитории, внесите это изменение до PR в main, чтобы помечаемый коммит уже содержал соответствующие примечания к релизу.

Пример:

export FIRMWARE_VERSION=v1.15.0
export POSADMESH_VERSION=v2026.5.1
bash posadmesh-build.sh build-observer-firmwares

git tag observer-posadmesh-v2026.5.1
git push origin observer-posadmesh-v2026.5.1

Поддерживаемые теги

  • companion-wifi-v1.15.0
  • repeater-bridge-espnow-v1.15.0
  • observer-posadmesh-bridge-espnow-v2026.5.1
  • observer-posadmesh-bridge-mqtt-v2026.7.0
  • observer-posadmesh-v2026.5.1