Интеграция TAK

Meshtastic integrates with the Team Awareness Kit (TAK) ecosystem, enabling interoperability between Meshtastic radios and TAK applications like ATAK and WinTAK.

Обзор

Модуль TAK позволяет нодам Meshtastic:

Делиться данными о местоположении в формате CoT (Cursor on Target), совместимом с TAK
Отображаться как члены команды на картах TAK
Получать сообщения PLI (информация о местоположении) TAK

Настройка

Необходимые условия

ATAK (Android Team Awareness Kit), iTAK, or WinTAK installed
Your node’s Device Role (Device configuration) set to TAK or TAK Tracker — this is what makes the TAK module appear in Module configuration at all
Firmware 2.8.0 or newer on the radio. Earlier firmware accepts a TAK config write and never stores it, so the app hides the TAK module entry below that version even when the role is set correctly. See Firmware Updates

⚠️ Warning: The old Meshtastic ATAK Plugin is no longer part of this path and cannot work. It bridged through the cross-process AIDL API, which was removed in app 2.8.0; the mesh service is now in-process only. Do not install it. Interop today runs over the app’s own local TAK server plus the Mesh to CoT Converter, both described in the following sections, with stock ATAK/iTAK/WinTAK.

Настройки

Navigate to Settings → Module configuration → TAK. The module’s own settings are your TAK identity — there is no separate enable switch here, because the Device Role setting in Device configuration is what turns TAK on. Your node broadcasts this identity, which appears on TAK maps.

Настройка	Описание
Цвет команды	Цвет твоей команды на карте TAK (например, Синий, Красный, Голубой, Зелёный)
Роль участника	Your operational role within that team (Team Member, Team Lead, HQ, Medic, RTO, etc.)

Your TAK callsign isn’t a separate setting — it’s derived automatically from your Meshtastic node name.

💡 Совет: Цвета команд/ролей являются стандартными цветами принадлежности в TAK. Coordinate with your TAK team to use consistent team assignments.

Локальный TAK-сервер

The app can also run a local TAK server so ATAK/iTAK on the same phone can connect directly, without a remote TAK server. Сервер привязывается только к локальному хосту (127.0.0.1:8089) и использует TLS с взаимной аутентификацией по сертификатам (mTLS), поэтому он недоступен с других устройств в сети.

Open Settings → Advanced → TAK Server. These are app settings stored on this phone, which is why they sit next to Firmware Update and Debug Panel rather than under the TAK module config — and why they need neither a TAK role nor firmware 2.8.0:

Настройки локального TAK-сервера с переключателем включения и опцией экспорта

Enable Local TAK Server — starts the loopback-only mTLS server on port 8089 for ATAK/iTAK connections from the same phone.
TAK Mesh Channel — выбирает, в какой канал Meshtastic отправляется исходящий трафик TAK (по умолчанию: основной канал, индекс 0). Входящий трафик TAK принимается с любого канала. Соответствует аналогичной настройке на iOS и в устаревшем плагине ATAK.
Mesh to CoT Converter — off by default, and shown under the server toggle. With the server running, this synthesizes a CoT contact for every node in your node database, so ordinary Meshtastic nodes appear on the ATAK map as contacts. This is what replaced the old plugin’s node visibility — without it, only TAK-role nodes show up.
Экспорт пакета данных TAK — создаёт пакет данных .zip, который ATAK/iTAK может импортировать для подключения к этому серверу.

Роли TAK

Ноды, настроенные с ролями, связанными с TAK, ведут себя иначе, чем стандартные клиенты:

Роль	Описание
TAK	Полная совместимость с TAK — отправляет и принимает данные CoT, сообщения чата и обновления PLI. Выполняет функции стандартного клиента и TAK-моста.
TAK Tracker	Вывод только координат в формате TAK — автоматически передаёт PLI через равные промежутки времени без участия пользователя. Оптимизирован для автономных маячков местоположения (транспортные средства, оборудование, путевые точки). Не ретранслирует сообщения чата.

Роль

Описание

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, поэтому ручное преобразование формата не требуется.

Формат передачи (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
Routes received from the mesh are also saved as a data package (.zip) in Downloads; import it in ATAK to add the route. On Android 9 and older the file goes to the app’s own folder under Android/data instead

ℹ️ Note: TAK integration requires specific node roles. Standard client nodes don’t automatically participate in TAK operations — though with Mesh to CoT Converter enabled they still appear on the ATAK map as contacts.

Устранение неполадок

Проблема	Причина	Решение
Нода не отображается на карте ATAK	Wrong Device Role setting, or Mesh to CoT Converter off	Set the node’s Device Role to TAK or TAK Tracker. For ordinary (non-TAK-role) nodes to appear, also enable Mesh to CoT Converter under Settings → Advanced → TAK Server
Данные о местоположении устарели	Потерян сигнал GPS или слишком большой интервал	Проверьте состояние GPS; уменьшите интервал передачи координат в настройках Position Config
ATAK shows “disconnected”	The local TAK server is off, or ATAK is pointed elsewhere	Check Enable Local TAK Server is on, and that ATAK is connecting to `127.0.0.1:8089` — re-import the exported data package if unsure
Фигуры, маркеры или маршруты не передаются	Отправляющая нода использует устаревший V1 (прошивка 2.7.x или старше)	Обновите прошивку отправляющей ноды до 2.8.0+ для использования формата передачи V2
Данные CoT не передаются	Несовпадение каналов	Все ноды TAK должны находиться на одном канале с одинаковым шифрованием

Соображения безопасности

🔒 Privacy: TAK data shares your position and callsign information. The TAK module respects the same channel encryption as other Meshtastic messages — in sensitive environments, use a channel with a non-default key.

Связанные темы

Настройки — Модули и администрирование — конфигурация модуля TAK
Ноды — роли TAK и TAK Tracker в списке нод
Карта и путевые точки — расположение нод на карте