miroslav.diyDIY hardware lab

Radio / SDR · ESP32

Mesh Panel

Meshtastic + MeshCore · Heltec V4 · LoRa 868 МГц

Панель управления собственной LoRa-сетью на Meshtastic и MeshCore: трекер на карте, узлы и радиосвязи, чат, журнал и настройки каждого узла с проверкой записи. Панель держит единственное TCP-подключение к базовым станциям Heltec V4 и отдаёт поток карте PotatoMesh в корне mesh.miroslav.diy.

Панель доступнаЗащищён
Открыть панель Открыть режим MeshCoreОткрыть карту PotatoMesh

mesh.miroslav.diy/panel/

Аппаратная часть

  • Heltec WiFi LoRa 32 V4 · Meshtastic 2.7.26
  • Heltec V4.3 · MeshCore 1.17.1 companion
  • SenseCAP T1000-E · LilyGO T-Echo · T-Deck
  • LilyGO T-Beam 1W · MeshCore-репитер

01 / PURPOSE

Что делает проект

Панель записывает телеметрию, пакеты и позиции базового узла Meshtastic в SQLite и показывает их на вкладках «Найти трекер» (путь точных позиций за 6 часов, сутки, неделю, 30 дней или всё время, выгрузка в GPX), «Мои устройства», «Карта сети», «Все узлы», «Журнал узла», «Чат» и «Настройки»; режим Bluetooth подключается к узлу прямо из браузера. Режим MeshCore показывает узлы и карту со связями из flood-путей, чат, журнал приёма и вкладки «База» и «Репитер»: настройки своего репитера меняются по воздуху с обратным чтением. В корне mesh.miroslav.diy открывается карта PotatoMesh с теми же чатами.

02 / SYSTEM

Архитектура

  • Узел Meshtastic и Wi-Fi-компаньон MeshCore принимают только одного TCP-клиента, поэтому оба подключения держит панель: для MeshCore — очередь команд, для Meshtastic — переподключение после потери связи или 3 минут тишины.
  • Каждая запись настроек читается обратно; если по радио вернулось старое значение, та же запись отправляется ещё раз. Удалённые узлы Meshtastic настраиваются по радио через PKC admin, чтение их настроек — не чаще раза в 10 минут на узел.
  • Редактор открывает 162 скалярных поля прошивки 2.7.26; ключи, регион, каналы и номера пинов не редактируются, поля, ошибка в которых может отрезать узел, требуют подтверждения.
  • Приватность: позиция базы Meshtastic не уходит ни в эфир, ни на публичные карты, точные координаты трекера идут только по приватному каналу track. Узлы MeshCore публикуют лишь центр ячейки 1×1 км, точная точка остаётся в панели.
  • PotatoMesh v0.7.5 получает поток через read-only зеркало панели — без ключей каналов, админ-трафика и точной позиции базы; панель копирует туда свои чаты, история хранится полгода.
  • Карта сети объединяет то, что слышит база, с картой сообщества map.mesh-net.by: данные запрашиваются на сервере раз в 5 минут, поэтому CSP страницы — только self и тайлы OSM.
  • Доступ: edge с ограничителем запросов → front (Caddy, персональная Basic Auth) → LXC apps на cubi; изменения принимаются только POST-запросом с заголовком X-Requested-With.

03 / LINKS

04 / PROVENANCE

Источники

  • README/root/projects/mesh-dashboard/README.md
  • GBrainprojects/mesh-dashboard

Описание и технические факты сверены с указанными каноническими источниками. Статус сверён прямой, публичной или LGTM-пробой .