range-test
Этот модуль позволяет протестировать дальность связи между двумя узлами Meshtastic. Только узлы с включенным модулем будут отображать сообщения теста дальности на подключенных клиентах.
- Отправитель: фиксированный узел, отправляющий последовательные пакеты («Интервал сообщений отправителя» от 30 до 60 с);
- Приемник: мобильный узел (обычно вы) опционально с встроенным или телефонным GPS.
Узлы находятся в зоне действия, пока последовательные пакеты могут быть получены.
Принимающий узел может использоваться для сохранения сообщений вместе с GPS-координатами, в которых они были получены, в файл .csv. Этот файл .csv затем может быть интегрирован в Google Earth, Google Maps - My Maps или любую другую программу, способную обрабатывать файлы .csv. Это позволит вам визуализировать вашу mesh-сеть. Убедитесь, что в канале по умолчанию установлена position precision на high, иначе собранные данные не запишут ваше истинное местоположение.
:::info
Обязательно выключите модуль или отключите отправку, когда он не используется. Это займет много времени на эфире, замедлит вашу mesh-сеть и заспамит канал. Модуль автоматически выключится через 8 часов.
:::
Параметры конфигурации модуля теста дальности: Enabled, Sender и Save. Конфигурация модуля Range Test использует admin-сообщение с protobuf ModuleConfig.RangeTestConfig.
Значения конфигурации модуля теста дальности
Enabled
Включает модуль теста дальности. И на отправителе, и на приемнике модуль должен быть включен. В приложениях для Apple и Android для получения сообщений теста дальности модуль должен быть включен. Экран устройства может продолжать показывать пакеты теста дальности из старых версий прошивки, даже если модуль отключен.
Sender Interval
Как долго ждать между отправкой последовательных тестовых пакетов. 0 — значение по умолчанию, которое отключает отправку сообщений.
Рекомендуемые настройки отправителя
| Radio Setting | range_test.sender |
|---|---|
| Long Slow | 60 |
| Long Fast | 30 |
| Medium | 15 |
| Short Fast | 15 |
Save CSV File
:::info
Оставьте отключенным при использовании приложений для Android или Apple. Сохраняет напрямую во флэш-память устройства (без необходимости смартфона) и доступно только на устройствах на базе ESP32.
:::
Если включено, все полученные сообщения сохраняются во флэш-память устройства в файл с именем rangetest.csv.
Чтобы получить доступ к этому файлу, сначала включите WiFi на устройстве и подключитесь к вашей сети. После подключения к устройству перейдите по адресу meshtastic.local/rangetest.csv (или your_device_ip/rangetest.csv), и файл автоматически скачается. Этот файл будет создан только после получения начальных сообщений.
Чтобы избежать переполнения хранилища, устройство прекратит запись, если на файловой системе останется менее 50 КБ свободного места.
Доступность конфигурации модуля теста дальности в клиентах
Android
:::info
Параметры конфигурации Range Test доступны для Android.
- Откройте приложение Meshtastic
- Перейдите в: Vertical Ellipsis (3 dots top right) > Radio Configuration > Range Test
:::
Android экспортирует файл rangetest.csv из пакетов в Debug Log. Чтобы очистить старые данные истории пакетов: Debug Panel > Clear
Apple
:::info Все параметры конфигурации модуля теста дальности доступны в iOS, iPadOS и macOS в Settings > Module Configuration > Range Test. :::
Приложения для Apple также имеют опцию загрузки записанных данных позиций, хранящихся на вашем iPhone/iPad/Mac. Доступ к ним: вкладка Nodes, выберите узел, затем Position Log и нажмите Save. Этот файл данных не требует активного модуля Range Test.
CLI
:::info
Параметры конфигурации модуля Range Test доступны в python CLI. Примеры команд ниже:
:::
| Setting | Acceptable Values | Default |
|---|---|---|
| range_test.enabled | true, false |
false |
| range_test.save | true, false |
false |
| range_test.sender | integer (Seconds) |
0 |
:::tip
Поскольку устройство перезагрузится после каждой отправленной команды через CLI, рекомендуется при установке нескольких значений в разделе конфигурации объединять команды в одну.
```shell title="Example:" meshtastic --set range_test.enabled true --set range_test.save false
:::
```shell title="Enable / Disable the range test"
meshtastic --set range_test.enabled true
meshtastic --set range_test.enabled false
```shell title="Enable / Disable range test save" meshtastic --set range_test.save true meshtastic --set range_test.save false
```shell title="Enable range test sender (send every 60 seconds)"
meshtastic --set range_test.sender 60
shell title="Disable range test sender"
meshtastic --set range_test.sender 0
Web
:::info
Все параметры конфигурации модуля теста дальности доступны в Web UI.
:::
Примеры применения
Интеграция с Google Earth
Шаги:
- Скачать и открыть Google Earth
- Выберите File > Import
- Выберите CSV
- Выберите Delimited, Comma
- Убедитесь, что кнопка «This dataset does not contain latitude/longitude information, but street addresses» снята с галочки
- Выберите «rx lat» & «rx long» для соответствующих полей lat/lng
- Нажмите finish
- Когда появится запрос на создание шаблона стиля, нажмите yes.
- Установите поле имени на ту колонку, которую хотите отображать на карте (не переживайте об этом сильно, при клике на иконку появятся все релевантные данные)
- Выберите цвет, иконку и т.д. и нажмите OK.
Ваши данные загрузятся на карту, убедитесь, что поставили галочку рядом с вашим набором данных в боковой панели, чтобы просмотреть его.
My Maps
Вы можете использовать My Maps. Оно принимает CSV, и весь интерфейс гораздо проще в использовании.
Google имеет инструкции, как это сделать, здесь.
Вы можете стилизовать дальности по-разному в зависимости от значений, чтобы пины были темнее, если SNR или RSSI (если это добавят) выше.
OpenStreetMap - uMap
Для открытого решения вы можете использовать uMap. Сервис на базе популярного проекта OpenStreetMap.
Посетите uMap на предпочитаемом языке. 1. Нажмите "Create a map" 2. Нажмите на иконку "Import data" или нажмите CTRL + I. 3. Выберите свой rangetest.csv и нажмите "Import". Формат данных распознается, и местоположения импортируются на карту.