Интеграция TAK
Meshtastic интегрируется с экосистемой Team Awareness Kit (TAK), обеспечивая взаимодействие между устройствами mesh-сети Meshtastic и приложениями TAK, такими как ATAK и WinTAK.
Обзор
Модуль TAK позволяет нодам Meshtastic:
- Делиться данными о местоположении в формате CoT (Cursor on Target), совместимом с TAK
- Отображаться как члены команды на картах TAK
- Получать сообщения PLI (информация о местоположении) TAK
Настройка
Необходимые условия
- Установлен ATAK (Android Team Awareness Kit) или WinTAK
- Установлен Meshtastic ATAK Plugin
- Модуль TAK включён на вашем радио Meshtastic
Настройки
- Перейдите в Настройки → Конфигурация модулей → TAK.
- Включите модуль TAK.
- Настройте параметры команды/группы TAK:

| Настройка | Описание |
|---|---|
| Включено | Активировано взаимодействие с TAK |
| Режим обмена | Режим вывода, совместимый с TAK |
Настройка плагина ATAK
- Установите Meshtastic ATAK Plugin из репозитория плагинов.
- Откройте ATAK и включите плагин Meshtastic.
- Плагин соединяет сообщения между ATAK и твоей mesh-сетью.
Локальный TAK-сервер
Приложение также может запускать локальный TAK-сервер, чтобы ATAK/iTAK на том же устройстве могли подключаться напрямую, без удалённого TAK-сервера. Сервер привязывается только к локальному хосту (127.0.0.1:8089) и использует TLS с взаимной аутентификацией по сертификатам (mTLS), поэтому он недоступен с других устройств в сети. Откройте Настройки → Конфигурация модулей → TAK → TAK-сервер:

- Включить локальный TAK-сервер — запускает mTLS-сервер только на локальную петлю на порту 8089 для подключений ATAK/iTAK с того же устройства.
- Экспорт пакета данных TAK — создаёт пакет данных
.zip, который ATAK/iTAK может импортировать для подключения к этому серверу.
Роли TAK
Ноды, настроенные с ролями, связанными с TAK, ведут себя иначе, чем стандартные клиенты:
| Роль | Описание |
|---|---|
| TAK | Полная совместимость с TAK — отправляет и принимает данные CoT, сообщения чата и обновления PLI. Выполняет функции стандартного клиента и TAK-моста. |
| TAK Tracker | Вывод только координат в формате TAK — автоматически передаёт PLI через равные промежутки времени без участия пользователя. Оптимизирован для автономных маячков местоположения (транспортные средства, оборудование, путевые точки). Не ретранслирует сообщения чата. |
💡 Совет: Используйте TAK Tracker для устройств, которым требуется только передавать координаты (например, радио, установленное в автомобиле). Используйте TAK для устройств, где пользователи активно участвуют в операциях TAK.
Формат CoT (Cursor on Target)
Сообщения TAK используют формат XML Cursor on Target — военный стандарт для обмена данными о ситуационной осведомлённости. Meshtastic преобразует свои внутренние сообщения protobuf в формат CoT при соединении с системами TAK, поэтому ручное преобразование формата не требуется.
Идентификация в TAK
При использовании ролей TAK твоя нода передаёт идентификационную информацию, которая отображается на картах TAK:
| Настройка | Описание |
|---|---|
| Цвет команды | Цвет твоей команды на карте TAK (например, Синий, Красный, Голубой, Зелёный) |
| Роль участника | Твоя оперативная роль (Team Member, Team Lead, HQ, Medic, RTO и т. д.) |
Эти настройки появляются в Настройки → Конфигурация модулей → TAK, когда модуль TAK включён. Твой позывной в TAK не задаётся отдельно — он автоматически берётся из имени твоей ноды Meshtastic.
💡 Совет: Цвета команд/ролей являются стандартными цветами принадлежности в TAK. Согласуй с твоей командой TAK использование единообразных назначений команд.
Формат передачи (V1 / V2)
Meshtastic поддерживает два формата передачи данных TAK, которые выбираются автоматически в зависимости от прошивки подключённого радио — ручная настройка не требуется:
| Формат | Совместимость | Особенности |
|---|---|---|
| V1 (Устаревший) | Прошивка 2.7.x и старше | Простое кодирование protobuf на порт 72. Поддерживает только передачу местоположения (PLI) и чат (GeoChat) — фигуры, маркеры, маршруты и другие типизированные события CoT отбрасываются |
| V2 (Текущий) | Прошивка 2.8.0 и новее | Компактное кодирование со сжатием zstd на порт 78. Добавляет типы CoT: фигуры, маркеры, маршруты, воздушные суда, эвакуацию, чрезвычайные ситуации и задачи — в дополнение ко всему, что поддерживает V1 |
Нода продолжает ретранслировать устаревшие пакеты V1 от старых нод, даже если сама работает на V2, поэтому смешанные по прошивке mesh-сети продолжают функционировать.
Использование с ATAK
После настройки:
- Ноды Meshtastic отображаются как маркеры на карте ATAK с подписями позывных
- Сообщения чата могут передаваться между mesh-сетью и сетями TAK
- Обновления местоположения передаются двунаправленно между Meshtastic и TAK
- Ноды TAK Tracker автоматически передают PLI — их координаты отображаются на картах ATAK без какой-либо настройки на стороне ATAK
⚠️ Примечание: Для интеграции с TAK требуются определённые роли нод и настройка модуля. Стандартные клиентские ноды не участвуют в операциях TAK автоматически.
Устранение неполадок
| Проблема | Причина | Решение |
|---|---|---|
| Нода не отображается на карте ATAK | Модуль TAK отключён или выбрана неверная роль | Убедитесь, что модуль TAK включён, а роль ноды — TAK или TAK Tracker |
| Данные о местоположении устарели | Потерян сигнал GPS или слишком большой интервал | Проверьте состояние GPS; уменьшите интервал передачи координат в настройках Position Config |
| Плагин ATAK показывает “не подключён” | Потеряно соединение BLE или произошёл сбой плагина | Переподключите Bluetooth в приложении Meshtastic, затем перезапустите плагин ATAK |
| Фигуры, маркеры или маршруты не передаются | Отправляющая нода использует устаревший V1 (прошивка 2.7.x или старше) | Обновите прошивку отправляющей ноды до 2.8.0+ для использования формата передачи V2 |
| Данные CoT не передаются | Несовпадение каналов | Все ноды TAK должны находиться на одном канале с одинаковым шифрованием |
Соображения безопасности
- Данные TAK передают ваше местоположение и позывной
- Убедись, что шифрование канала настроено при использовании TAK в чувствительных средах
- Модуль TAK соблюдает то же шифрование канала, что и другие сообщения Meshtastic
Связанные темы
- Настройки — Модули и администрирование — конфигурация модуля TAK
- Ноды — роли TAK и TAK Tracker в списке нод
- Карта и путевые точки — расположение нод на карте
- Руководство по плагину ATAK — подробная настройка ATAK на meshtastic.org