# Crypto Mesh Map

## Українською

У браузері перемикач UA / EN відкриває [українську мапу](/) або [англійську мапу](/en/). У застосунку вибір мови зберігається на пристрої.

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

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

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

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

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

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

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

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

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

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

Щоб опитувати репітер через Companion, запустіть у локальному проєкті `scripts/meshcore-telemetry-agent.py`. Токен Observer береться з кабінету. Інструкція з запуску є в `agents.md`.

### Навігація

На широкому екрані кнопки доступні у шапці, а журнал закріплено праворуч. На телефоні й більшості планшетів у портретному режимі мапа та журнал відкриваються на всю ширину. Знизу доступні «Мапа», «Пакети», #Public, «Додати ноду», LoS і «Кабінет». Інструкція та Android APK доступні в шапці. Налаштування мапи прокручуються окремо, залишаючи доступ до кнопок масштабу. На вузьких екранах вкладки кабінету розміщуються у два ряди.

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

У кабінеті відкрийте Observer і виберіть точну модель плати. Список ролей залежить від плати. Companion BLE підключається до телефона, Companion USB — кабелем до клієнта, Repeater ретранслює пакети, а Room Server зберігає повідомлення кімнати. KISS і самостійний клієнт доступні на підтримуваних моделях. Готові команди Wi-Fi та MQTT показано лише для сумісних прошивок Gessaman. Увімкніть третій MQTT-слот після перевірки, що плата й збірка його підтримують. [MeshCore Flasher](https://flasher.meshcore.io/) · [Gessaman Observer](https://observer.gessaman.com/?config=mqtt-observer)

BMP280 вимірює температуру й атмосферний тиск. BME280 також вимірює вологість. На знеструмленій платі підключіть модуль I²C до 3,3 В, GND, SDA та SCL за схемою конкретної ревізії. Перевірте адресу 0x76 або 0x77 і підтримку датчика у збірці. Якщо нода вже працює як Repeater або Room Server, спочатку запитайте Telemetry через Companion з дозволом на дані середовища. Sensor — окремий приклад для збірки з вихідного коду. [Драйвер датчиків MeshCore](https://github.com/meshcore-dev/MeshCore/blob/main/src/helpers/sensors/EnvironmentSensorManager.cpp) · [Simple Sensor](https://github.com/meshcore-dev/MeshCore/tree/main/examples/simple_sensor)

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

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

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

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

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

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

Модель плати відображається за наявності даних. Стандартне радіооголошення MeshCore містить ідентифікатор ноди, а модель плати передається окремо.

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

Натисніть «Обрати існуючу ноду» біля точки A або B. Ноди згруповані за регіоном і впорядковані за назвою. Скористайтеся пошуком за назвою, публічним ключем чи регіоном або виберіть регіон у фільтрі.

У розділі «Одиниці відстані» натисніть «Кілометри» або «Милі». Обидві кнопки доступні на сайті та в Android. Вибір зберігається й одразу змінює відстань і горизонтальну вісь графіка. У режимі миль висоти антен, рельєф, зазор Френеля та крок вибірки показано у футах. У режимі кілометрів використовуються метри.

Відкрийте LoS з нижнього меню телефона або з шапки на широкому екрані. Натисніть «Вказати А на мапі» або «Вказати Б на мапі». Торкніться мапи, щоб поставити мітку, і натисніть «Підтвердити». Повторне торкання переміщує мітку. Кнопка «Показати точки на мапі» відкриває мапу з обраними точками. «Очистити профіль» прибирає мітки, лінію та графік. Для нової траси виберіть інші точки A і B.

Виберіть дві точки або ноди й задайте висоту кожної антени над землею. Для 868 МГц зелений статус означає вільну пряму й 60% першої зони Френеля, жовтий — часткове перекриття зони Френеля, червоний — перешкоду на прямій між антенами. Графік показує крок вибірки. На довгих трасах він збільшується через ліміт у 100 точок. Висоти надходять із [Copernicus DEM GLO-90 через Open-Meteo](https://open-meteo.com/en/docs/elevation-api). Профіль дає попередню оцінку за рельєфом. Перевірка зв’язку на місці врахує й місцеві перешкоди та радіоумови.

Мітки A і B можна перетягнути на мапі мишею або пальцем. Після переміщення розрахуйте профіль повторно.

### Пакети та #Public

«Приклад пакета» відкриває збережений прийом Observer. Якщо Observer передав виміри RSSI та SNR, вони відображаються у прикладі.

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

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

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

## English

In a browser, the UA / EN switch opens the [Ukrainian map](/) or the [English map](/en/). In the app, the language choice is saved on the device.

Use the LoRa node map to find MeshCore repeaters in Ukraine and around the world. The MeshCore packet analyzer shows receptions reported by Observers. The line-of-sight tool estimates visibility between nodes from terrain data.

### How a node appears on the map

A Companion, Repeater or Room Server can broadcast a LoRa ADVERT without internet access. When an Observer receives an advert with coordinates and forwards it to the server over MQTT or HTTPS, the node can appear on the map. The packet feed shows receptions forwarded by an Observer.

To enter node details manually, sign in and open “Add Node”. Enter the name, role, region, coordinates and full MeshCore public key. A manual entry starts offline. The server must receive fresh data before the node appears in the public active layer. Confirm ownership of a physical node in the cabinet with a signed ADVERT.

If the gateway loses internet access, a computer connected to a Companion can capture received frames to a local file. The site currently has no historical capture import. When the connection returns, the gateway can forward new receptions again.

### Telemetry and linking

Missing measurements show No data. Voltage can arrive separately from battery percentage. To link an unclaimed radio node, request a code in the cabinet, temporarily set it as the node name and send an ADVERT. The code expires after 10 minutes. Restore the previous name once the node is linked. Remove from map takes the node off the public map and keeps it in the cabinet. Show on map restores its visibility.

In the cabinet, open your node and select Edit telemetry. Change a reading or erase it and save. Clear all readings clears the current charge, voltage, and temperature. Enter a new reading manually, fetch it over Bluetooth, or send it from an Observer. Measurement history and weather readings are preserved.

In Android app 2.2.4, choose Refresh via Bluetooth in your node card, allow Nearby devices and select your Companion by name. The list includes nearby Bluetooth LE devices and devices already paired with the phone. Disconnect the Companion from another app if that app is using the link. This feature requires Android 6 or newer.

The Companion queries the Repeater or Room Server over LoRa. The remote node must be in this Companion’s contacts. If the node does not reply, the app tries guest login. If prompted, enter the node’s MeshCore password in the Android dialog. The app sends it to the Companion over Bluetooth.

To query a repeater through a Companion, run `scripts/meshcore-telemetry-agent.py` in the local project. Use the Observer token from your cabinet. See `agents.md` for setup.

### Navigation

Wide screens show actions in the header. The feed is docked on the right on wide screens. On phones and most tablets in portrait mode, the map and feed each use the full width. The bottom bar shows Map, Packets, #Public, Add Node, LoS and Cabinet at the bottom. The guide and Android APK are in the header. Map settings scroll separately and leave the zoom buttons accessible. Cabinet tabs use two rows on narrow screens.

### Boards, firmware and sensors

Open Observer in the cabinet and select the exact board model. Available roles depend on the board. Companion BLE connects to a phone, Companion USB connects to a client by cable, Repeater relays packets, and Room Server stores room messages. KISS and standalone clients are available on compatible boards. Wi-Fi and MQTT commands are available for compatible Gessaman builds. Enable the third MQTT slot after checking that the board and build support it. [MeshCore Flasher](https://flasher.meshcore.io/) · [Gessaman Observer](https://observer.gessaman.com/?config=mqtt-observer)

BMP280 measures temperature and air pressure. BME280 also measures humidity. With the board powered off, connect the I²C module to 3.3 V, GND, SDA and SCL using the pinout for your board revision. Check the sensor address (0x76 or 0x77) and driver support in the firmware. On an existing Repeater or Room Server, first request Telemetry through a Companion with permission to read environmental data. Simple Sensor is a separate example built from source. [MeshCore sensor driver](https://github.com/meshcore-dev/MeshCore/blob/main/src/helpers/sensors/EnvironmentSensorManager.cpp) · [Simple Sensor](https://github.com/meshcore-dev/MeshCore/tree/main/examples/simple_sensor)

If the BME280 is attached to the Companion itself, open that Companion’s cabinet card and tap Refresh via Bluetooth in Android 2.2.4. The firmware must report temperature, humidity and pressure on the same external Cayenne LPP channel. The weather section shows the values and measurement time in the cabinet and on the map for a visible node. For periodic readings, run the Python agent on a gateway with `--interval 300` and omit `--target`.

### Map search and settings

Use Layers to open map settings and × to close them. World, Europe and Ukraine move the map. The Observer region filter changes which nodes appear. This browser remembers the language, layers, theme, filter and map view.

### Markers and layers

The marker letter shows the node role. The shield shows its verification status. Open the node card for the last signal and location mode. A dashed purple circle shows the privacy radius. The blue circle estimates range by node type.

RF Links counts directed links between nodes recorded from received packet routes. A → B and B → A count separately. Both nodes must be visible and active in the last 24 hours. Tap the count in the header or open the map legend for an explanation.

The node card shows the board model when available. Standard MeshCore advertisements carry the node identity, while board details come from a separate source.

### Radio profile (LoS)

Choose Select existing node for point A or B. The picker groups nodes by region and sorts them by name. Search by name, public key, or region, or narrow the list with the region filter.

Under Distance units, tap Kilometers or Miles. Both buttons are available on the website and in Android. Your choice is saved and updates the distance and horizontal chart axis immediately. Miles mode shows antenna height, terrain elevation, Fresnel clearance and sample spacing in feet. Kilometers mode uses meters for those values.

Open LoS from the bottom bar on a phone or the header on a wide screen. Choose Pick A on Map or Pick B on Map. Tap the map to place the pin, then choose Confirm. Tap again to move the pin before confirming. Show points on map fits the selected points in the map view. Clear profile removes the pins, line and chart. Choose new points A and B to start a different route.

Choose two points or nodes and set each antenna's height above ground. At 868 MHz, green means the direct path and 60% of the first Fresnel zone are clear. Amber indicates partial Fresnel obstruction. Red indicates that terrain blocks the direct path. The chart shows the sample spacing, which grows on long routes because the profile is limited to 100 points. Elevations come from [Copernicus DEM GLO-90 via Open-Meteo](https://open-meteo.com/en/docs/elevation-api). The profile gives a preliminary terrain-based estimate. A field test captures local obstacles and radio conditions.

Drag pin A or B on the map with your mouse or finger. Recalculate the profile after moving a pin.

### Packets and #Public

Packet Example opens a saved reception from an Observer. When the Observer supplied RSSI and SNR measurements, the example displays them.

Use the node card, receiving observer and time range to filter packets. Pause holds the live feed while you inspect it. Receptions with the same radio hash are grouped within two minutes. Select a reception to inspect its signal and show its observed route on the map. A missing measurement is shown as such. The packet card shows frame structure, and the receiving observer’s owner can open the original HEX. The #Public tab still shows the latest 100 messages.

### Node visibility

The map shows nodes active in the last 24 hours. Linked nodes remain in the cabinet and reappear on the map after a new signal.

## Вхід і безпека кабінету / Cabinet sign-in and security

- Увійдіть за логіном або email і паролем карти. Для нового пароля потрібно щонайменше 8 символів. Для зміни email чи пароля введіть поточний пароль. Сеанс діє 24 години. Вихід завершує цей сеанс, а зміна пароля завершує всі попередні сеанси.
- Sign in with your map username or email and password. New passwords need at least 8 characters. Enter your current password to change your email or password. A session lasts 24 hours. Signing out ends that session. Changing your password ends all earlier sessions.

## Приклад пакета і радіопараметри / Packet example and radio settings

- «Приклад пакета» відкриває останній збережений радіоприйом Observer. Якщо для прийому відомі RSSI, SNR, радіопараметри або переходи, вони показані у картці. Власник може ввести параметри зі своєї ноди у формі редагування. «Оновити активність» перечитує дані кабінету.
- Packet Example opens the latest saved radio reception from an Observer. The card shows the signal, radio settings and hops recorded for that reception when available. Owners can enter their node's configured radio settings in the edit form. Refresh activity reloads the cabinet data.

## Версія Android APK / Android APK version

- У застосунку натисніть номер версії або «APK» у шапці. У вікні відображаються встановлена версія та доступна версія для завантаження. У браузері відображається доступна версія.
- In the app, tap the version number or “APK” in the header. The dialog shows the installed version and the version available to download. A regular browser shows the available version.

## GitHub і Telegram / GitHub and Telegram

- Щоб додати спосіб входу до наявного кабінету, увійдіть у нього і відкрийте «Профіль та безпека». Підтвердьте вхід у GitHub чи Telegram. В Android 2.2.7 після підтвердження натисніть «Відкрити застосунок» у браузері. У версіях 2.2.5 і 2.2.6 поверніться до Crypto Mesh Map вручну. Якщо попередня спроба залишилася незавершеною, натисніть «Почати вхід заново».
- To add a sign-in method to your existing cabinet, sign in and open Profile & Security. Complete confirmation at GitHub or Telegram. In APK 2.2.7, select “Open app” in the browser after confirming. In versions 2.2.5 and 2.2.6, switch back to Crypto Mesh Map manually. If an earlier attempt is still pending, select “Start sign-in again”.
