mirror of
https://github.com/meshtastic/Meshtastic-Android.git
synced 2026-10-03 09:04:32 -04:00
136 lines
15 KiB
HTML
136 lines
15 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="ru-rRU" dir="ltr">
|
|
<head>
|
|
<meta charset="UTF-8">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
<title>Интеграция TAK</title>
|
|
<link rel="stylesheet" href="../../styles/docs.css">
|
|
</head>
|
|
<body data-page="tak" data-locale="ru-rRU">
|
|
<pre class="markdown-content"># Интеграция 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
|
|
|
|
### Настройки
|
|
|
|
1. Перейдите в **Настройки → Конфигурация модулей → TAK**.
|
|
2. Включите модуль TAK.
|
|
3. Настройте параметры команды/группы TAK:
|
|
|
|
|
|
|
|
Настройка | Описание |
|
|
------------ | --------------------------------- |
|
|
Включено | Активировано взаимодействие с TAK |
|
|
Режим обмена | Режим вывода, совместимый с TAK |
|
|
|
|
### Настройка плагина ATAK
|
|
|
|
1. Установите Meshtastic ATAK Plugin из репозитория плагинов.
|
|
2. Откройте ATAK и включите плагин Meshtastic.
|
|
3. Плагин соединяет сообщения между ATAK и твоей mesh-сетью.
|
|
|
|
### Локальный TAK-сервер
|
|
|
|
Приложение также может запускать **локальный TAK-сервер**, чтобы ATAK/iTAK на **том же устройстве** могли подключаться напрямую, без удалённого TAK-сервера. Сервер привязывается только к локальному хосту (`127.0.0.1:8089`) и использует TLS с взаимной аутентификацией по сертификатам (mTLS), поэтому он недоступен с других устройств в сети. Откройте **Настройки → Конфигурация модулей → TAK → TAK-сервер**:
|
|
|
|
|
|
|
|
- **Включить локальный TAK-сервер** — запускает mTLS-сервер только на локальную петлю на порту **8089** для подключений ATAK/iTAK с того же устройства.
|
|
- **TAK Mesh Channel** — selects which Meshtastic channel outgoing TAK traffic is sent on (default: the primary channel, index 0). Incoming TAK traffic is accepted from any channel. Matches the equivalent setting on iOS and in the legacy ATAK plugin.
|
|
- **Экспорт пакета данных 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
|
|
|
|
## Связанные темы
|
|
|
|
- [Настройки — Модули и администрирование](settings-module-admin) — конфигурация модуля TAK
|
|
- [Ноды](nodes) — роли TAK и TAK Tracker в списке нод
|
|
- [Карта и путевые точки](map-and-waypoints) — расположение нод на карте
|
|
- [Руководство по плагину ATAK](https://meshtastic.org/docs/software/integrations/integrations-atak-plugin/) — подробная настройка ATAK на meshtastic.org
|
|
|
|
---
|
|
|
|
</pre>
|
|
</body>
|
|
</html> |