Гід по мапі MeshCore та мережі LoRa

У браузері перемикач UA / EN відкриває українську мапу або англійську мапу. Виберіть «Україна», щоб знайти вузли LoRa й ретранслятори MeshCore на мапі, аналізувати радіопакети та розраховувати радіовидимість (LoS) за рельєфом.

Зміст інструкції

Як нода потрапляє на мапу

Companion, Repeater або Room Server може передавати радіооголошення ADVERT через LoRa без інтернету. Якщо оголошення з координатами прийняв Observer і передав його на сервер через MQTT або HTTPS, нода з’являється на мапі. У журналі видно прийоми, які передав Observer.

Щоб додати дані вручну, увійдіть і відкрийте «Додати ноду». Вкажіть назву, роль, регіон, координати та повний публічний ключ MeshCore. Ручний запис створюється зі статусом офлайн. Для появи в публічному шарі активних нод сервер має отримати свіжі дані. Прив’язку фізичної ноди підтвердіть у кабінеті через підписаний ADVERT.

Якщо шлюз без інтернету, можна записати прийняті кадри у файл на комп’ютері, підключеному до Companion. Коли зв’язок відновиться, шлюз знову зможе передавати нові прийоми.

Телеметрія та прив’язка

Поля без виміру показують «Немає даних». Напруга може надійти окремо від відсотка заряду. Щоб прив’язати вільну радіоноду, отримайте код у кабінеті, тимчасово встановіть його як ім’я ноди і надішліть ADVERT. Код діє 10 хвилин. Після прив’язки поверніть попереднє ім’я. Кнопка «Видалити з мапи» прибирає ноду з публічної мапи, зберігаючи її в кабінеті, а «Показати на мапі» відновлює її видимість.

У кабінеті відкрийте ноду та натисніть «Редагувати телеметрію». Змініть показник або зітріть його й збережіть. «Очистити всі показники» прибирає поточні заряд, напругу та температуру. Новий вимір можна ввести вручну, отримати через Bluetooth або передати з Observer. Історія вимірів і погодні дані зберігаються.

В Android на картці ноди натисніть «Оновити через Bluetooth», дозвольте доступ до пристроїв поблизу й виберіть свій Companion за назвою. Список містить пристрої Bluetooth LE поблизу та вже спарені з телефоном. Якщо Companion зайнятий іншим застосунком, спочатку від’єднайте його там. Потрібен Android 6 або новіший.

Companion опитує Repeater або Room Server через LoRa. Віддалена нода має бути в контактах цього Companion. Якщо нода не відповідає, застосунок пробує гостьовий вхід або запитує пароль MeshCore, який передається до Companion через Bluetooth.

Для автоматичного опитування репітерів через шлюз використовуйте scripts/meshcore-telemetry-agent.py із токеном Observer з кабінету.

Плати, прошивки та датчики

У кабінеті відкрийте Observer і виберіть точну модель плати. Список ролей залежить від плати: Companion BLE підключається до телефона, Companion USB — кабелем до клієнта, Repeater ретранслює пакети, а Room Server зберігає повідомлення кімнати. Готові команди Wi-Fi та MQTT показано для сумісних прошивок Gessaman. Корисні інструменти: MeshCore Flasher · Gessaman Observer.

BMP280 вимірює температуру й атмосферний тиск, а BME280 додатково вимірює вологість. На знеструмленій платі підключіть модуль I²C до 3,3 В, GND, SDA та SCL, перевірте адресу 0x76 або 0x77 і підтримку датчика у збірці (Драйвер датчиків MeshCore · Simple Sensor).

Якщо BME280 підключено до самого Companion, виберіть картку цього Companion у кабінеті й натисніть «Оновити через Bluetooth» в Android. Прошивка має віддати температуру, вологість і тиск в одному зовнішньому каналі Cayenne LPP. Для періодичних вимірювань запустіть Python-агент на шлюзі з --interval 300 без --target.

Пошук і налаштування мапи

Кнопка «Шари» відкриває налаштування мапи, а × закриває їх. «Світ», «Європа» й «Україна» переміщують мапу. Фільтр за кодом Observer змінює набір видимих нод. Мова, шари, тема, фільтр і положення мапи зберігаються в браузері.

Позначки та шари

Літера в маркері позначає тип ноди, а щиток — статус підтвердження. Картка ноди містить час останнього сигналу й режим координат. Фіолетовий пунктир — радіус розмиття координат, блакитне коло — оцінка дальності за типом ноди.

«Радіозв’язки (RF)» показують спрямовані переходи між нодами, зафіксовані в маршрутах прийнятих пакетів. A → B і B → A рахуються окремо; обидві ноди мають бути видимі й активні за останні 24 години. Модель плати відображається за наявності даних.

Радіопрофіль (LoS)

Відкрийте LoS і виберіть «Обрати існуючу ноду» або вкажіть точки A та B безпосередньо на мапі (мітки можна перетягувати мишею або пальцем). У розділі «Одиниці відстані» перемикайтеся між кілометрами (метри для висот) та милями (фути).

Задайте висоту кожної антени над землею. Для 868 МГц зелений статус означає вільну пряму й 60% першої зони Френеля, жовтий — часткове перекриття зони Френеля, червоний — перешкоду на прямій між антенами. Висоти надходять із Copernicus DEM GLO-90 через Open-Meteo.

Пакети та #Public

«Приклад пакета» відкриває збережений прийом Observer з RSSI, SNR, радіопараметрами та переходами. Прийоми з однаковим хешем згруповано в межах двох хвилин. Повний HEX доступний власнику Observer. Вкладка #Public показує останні 100 публічних повідомлень.

Видимість нод

Мапа показує ноди, які були активні за останні 24 години. Прив’язані ноди залишаються в кабінеті й повертаються на мапу після нового сигналу.

Вхід у кабінет, Android APK, GitHub і Telegram

Увійдіть за логіном або email і паролем (від 8 символів). Сеанс діє 24 години; зміна пароля завершує всі попередні сеанси. У кабінеті («Профіль та безпека») можна підключити вхід через GitHub або Telegram.

У Android-застосунку натисніть номер версії або «APK» у шапці, щоб перевірити встановлену та доступну версії для завантаження.