mirror of
https://github.com/meshtastic/Meshtastic-Android.git
synced 2026-10-03 00:54:34 -04:00
131 lines
11 KiB
HTML
131 lines
11 KiB
HTML
<!DOCTYPE html>
|
||
<html lang="ja-rJP" 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="ja-rJP">
|
||
<pre class="markdown-content"># TAK 連携
|
||
|
||
Meshtastic integrates with the Team Awareness Kit (TAK) ecosystem, enabling interoperability between Meshtastic radios and TAK applications like ATAK and WinTAK.
|
||
|
||
## 概要
|
||
|
||
TAK モジュールを使うと、Meshtastic のノードは次のことができます：
|
||
|
||
- TAK 互換の CoT（Cursor on Target）形式で位置データを共有する
|
||
- TAK のマップ表示上にチームメンバーとして表示される
|
||
- TAK の PLI（位置情報）メッセージを受信する
|
||
|
||
## セットアップ
|
||
|
||
### 前提条件
|
||
|
||
- 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](firmware)
|
||
|
||
> ⚠️ **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. サーバーは localhost のみ（`127.0.0.1:8089`）にバインドし、相互証明書認証（mTLS）による TLS を使用するため、ネットワーク上の他のデバイスからは到達できません。
|
||
|
||
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:
|
||
|
||
|
||
|
||
- **Enable Local TAK Server** — starts the loopback-only mTLS server on port **8089** for ATAK/iTAK connections from the same phone.
|
||
- **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.
|
||
- **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 データパッケージをエクスポート**：ATAK／iTAK がこのサーバーに接続するためにインポートできる `.zip` データパッケージを生成します。
|
||
|
||
## TAK の役割
|
||
|
||
TAK 関連の役割を設定したノードは、標準のクライアントとは動作が異なります：
|
||
|
||
役割 | 説明 |
|
||
--------------- | --------------------------------------------------------------------------------------------------------- |
|
||
**TAK** | 完全な TAK 相互運用。CoT データ、チャットメッセージ、PLI 更新を送受信します。標準のクライアントとして機能し、さらに TAK ブリッジも兼ねます。 |
|
||
**TAK Tracker** | 位置情報のみの TAK 出力。ユーザーの操作なしに、一定間隔で自動的に PLI をブロードキャストします。無人の位置ビーコン（車両、機材、ウェイポイント）に最適化されています。チャットメッセージは中継しません。 |
|
||
|
||
> 💡 **ヒント：** 位置の報告だけが必要なデバイス（例：車両に取り付けた無線機）には **TAK Tracker** を使用します。ユーザーが TAK の運用に積極的に参加するデバイスには **TAK** を使用します。
|
||
|
||
### CoT（Cursor on Target）形式
|
||
|
||
TAK のメッセージは Cursor on Target の XML 形式を使用します。これは状況認識データを共有するための軍事標準です。 Meshtastic は、TAK システムに橋渡しする際に内部の protobuf メッセージを CoT 形式に変換するため、手動での形式変換は必要ありません。
|
||
|
||
## ワイヤ形式（V1／V2）
|
||
|
||
Meshtastic は 2 つの TAK ワイヤ形式に対応しており、接続中の無線機のファームウェアに基づいて自動的に選択されます。手動での設定は必要ありません：
|
||
|
||
形式 | 互換性 | 機能 |
|
||
-------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------- |
|
||
V1（レガシー） | ファームウェア 2.7.x 以前 | ポート 72 での素の protobuf エンコード。位置共有（PLI）とチャット（GeoChat）のみに対応。図形、マーカー、ルート、その他の型付き CoT イベントは破棄されます |
|
||
V2（現行） | ファームウェア 2.8.0 以降 | ポート 78 でのコンパクトな zstd 圧縮エンコード。 V1 が対応するすべてに加えて、図形、マーカー、ルート、航空機、casevac、緊急、タスクの CoT タイプを追加します |
|
||
|
||
ノードは V2 を実行していても、古いノードからのレガシーな V1 パケットを引き続き中継するため、ファームウェアが混在したメッシュでも動作し続けます。
|
||
|
||
## ATAK での使用
|
||
|
||
設定が完了すると：
|
||
|
||
- Meshtastic のノードが、コールサインのラベル付きで ATAK のマップにマーカーとして表示されます
|
||
- チャットメッセージを、メッシュと TAK ネットワークの間で橋渡しできます
|
||
- 位置の更新が、Meshtastic と TAK の間で双方向に流れます
|
||
- TAK Tracker のノードは自動的に PLI をブロードキャストします。ATAK 側の設定なしで、その位置が ATAK のマップに表示されます
|
||
|
||
> ℹ️ **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 の状態を確認し、位置情報設定で位置のブロードキャスト間隔を短くする |
|
||
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 以前）である | V2 ワイヤ形式にするため、送信側のノードのファームウェアを 2.8.0 以降に更新する |
|
||
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.
|
||
|
||
## 関連トピック
|
||
|
||
- [設定：モジュールと管理](settings-module-admin)：TAK モジュールの設定
|
||
- [ノード](nodes)：ノードリストの TAK と TAK Tracker の役割
|
||
- [マップとウェイポイント](map-and-waypoints)：マップ上のノードの位置
|
||
</pre>
|
||
</body>
|
||
</html> |