mirror of
https://github.com/meshtastic/Meshtastic-Android.git
synced 2026-10-03 00:54:34 -04:00
122 lines
12 KiB
HTML
122 lines
12 KiB
HTML
<!DOCTYPE html>
|
||
<html lang="fi-rFI" dir="ltr">
|
||
<head>
|
||
<meta charset="UTF-8">
|
||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||
<title>TAK-integraatio</title>
|
||
<link rel="stylesheet" href="../../styles/docs.css">
|
||
</head>
|
||
<body data-page="tak" data-locale="fi-rFI">
|
||
<pre class="markdown-content"># TAK-integraatio
|
||
|
||
Meshtastic integroituu Team Awareness Kit (TAK) -ekosysteemiin, mikä mahdollistaa yhteentoimivuuden Meshtastic-radioiden ja TAK-sovellusten, kuten ATAKin ja WinTAKin, välillä.
|
||
|
||
## Yleiskatsaus
|
||
|
||
TAK-moduuli mahdollistaa Meshtastic-radioille:
|
||
|
||
- Sijaintidatan jakamisen TAK-yhteensopivassa CoT (Cursor on Target) -muodossa
|
||
- Näkyä tiimin jäseninä TAK-karttanäkymissä
|
||
- Vastaanottaa TAK PLI (Position Location Information) -viestejä
|
||
|
||
## Asetukset
|
||
|
||
### Edellytykset
|
||
|
||
- Asennettuna ATAK (Android Team Awareness Kit), iTAK tai WinTAK
|
||
- 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)
|
||
|
||
> ⚠️ **Varoitus:** Vanha **Meshtastic ATAK Plugin** ei enää kuulu tähän kokonaisuuteen eikä toimi. Yhteentoimivuus toteutetaan sovelluksen sisäisen paikallisen AIDL-rajapinnan kautta, joka poistettiin sovelluksesta 2.8.0. Mesh-palvelu toimii nyt vain sovelluksen sisäisenä. Älä asenna sitä. 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.
|
||
|
||
### Asetukset
|
||
|
||
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. Radiosi lähettää tämän tunnuksen, joka näkyy TAK-kartoilla.
|
||
|
||
Asetus | Kuvaus |
|
||
------------- | --------------------------------------------------------------------------------------------------------------------------- |
|
||
Tiimin väri | TAK-kartan tiimiväri (esim. sininen, punainen, syaani, vihreä) |
|
||
Jäsenen rooli | Toiminnallinen roolisi kyseisessä ryhmässä (Team Member, Team Lead, HQ, Medic, RTO jne.) |
|
||
|
||
TAK-kutsutunnuksesi ei ole erillinen asetus — se muodostetaan automaattisesti Meshtastic-radiosi nimestä.
|
||
|
||
> 💡 **Vinkki:** Tiimi- ja roolivärit ovat TAK-järjestelmän standardeja ryhmävärikoodauksia. Sovi TAK-ryhmäsi kanssa yhtenäisistä ryhmämäärityksistä.
|
||
|
||
### Paikallinen TAK-palvelin
|
||
|
||
Sovellus voi myös käyttää **paikallista TAK-palvelinta**, jolloin samalla puhelimella oleva ATAK tai iTAK voi muodostaa siihen yhteyden suoraan ilman etä-TAK-palvelinta. Palvelin kuuntelee vain paikallisia yhteyksiä (127.0.0.1:8089) ja käyttää TLS:ää molemminpuolisella varmenteiden todentamisella.
|
||
|
||
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:
|
||
|
||
|
||
|
||
- **Ota paikallinen TAK-palvelin käyttöön** — käynnistää vain loopback-yhteyttä käyttävän mTLS-palvelimen portissa **8089** samalla puhelimella olevien ATAK- ja iTAK-yhteyksien käyttöön.
|
||
- **TAK-mesh-kanava** – valitsee, mitä Meshtastic-kanavaa käytetään lähtevään TAK-liikenteeseen (oletuksena ensisijainen kanava, indeksi 0) Saapuva TAK-liikenne hyväksytään miltä tahansa kanavalta. Vastaa iOS:n ja vanhan ATAK-liitännäisen vastaavaa asetusta.
|
||
- **Mesh to CoT Converter** — oletusarvoisesti pois käytöstä, ja näkyy palvelinkytkimen alla. Kun palvelin on käynnissä, se luo CoT-yhteystiedon jokaisesta radiosolmujen tietokannan radiosta, jolloin tavalliset Meshtastic-radiot näkyvät ATAK-kartalla yhteystietoina. **Tämä korvaa vanhan lisäosan näkyvyyden** — ilman tätä näkyvät vain TAK-roolin radiot.
|
||
- **Vie TAK-tietopaketti** — luo `.zip`-tietopaketin, jonka ATAK/iTAK voi tuoda muodostaakseen yhteyden tähän palvelimeen.
|
||
|
||
## TAK-roolit
|
||
|
||
TAK-rooleilla määritetyt radiot käyttäytyvät eri tavalla kuin tavalliset client-laitteet:
|
||
|
||
Rooli | Kuvaus |
|
||
--------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
||
**TAK** | Täysi TAK-yhteentoimivuus — lähettää ja vastaanottaa CoT-dataa, chat-viestejä ja PLI-päivityksiä. Toimii tavallisen clientin lisäksi TAK-siltana. |
|
||
**TAK Tracker** | Vain sijaintitietoihin perustuva TAK-lähtö — lähettää automaattisesti PLI-dataa säännöllisin väliajoin ilman käyttäjän toimintaa. Optimoitu valvomattomiin sijaintilähettimiin (ajoneuvot, laitteet ja reittipisteet). Ei välitä chat-viestejä. |
|
||
|
||
> 💡 **Vinkki:** Käytä **TAK Tracker** -tilaa laitteille, joiden tarvitsee vain lähettää sijainti (esim. ajoneuvoon asennettu radio). Käytä **TAK**-tilaa laitteille, joissa käyttäjät osallistuvat aktiivisesti TAK-toimintaan.
|
||
|
||
### CoT (Cursor on Target) -muoto
|
||
|
||
TAK-viestit käyttävät Cursor on Target XML -muotoa — sotilaskäytössä olevaa standardia tilannetiedon jakamiseen. Meshtastic muuntaa sisäiset protobuf-viestinsä CoT-muotoon silloin, kun se välittää dataa TAK-järjestelmiin, joten manuaalista muunnosta ei tarvita.
|
||
|
||
## Wire Format (V1 / V2)
|
||
|
||
Meshtastic tukee kahta TAK-siirtomuotoa, jotka valitaan automaattisesti yhdistetyn radion laiteohjelmiston perusteella — manuaalisia asetuksia ei tarvita:
|
||
|
||
Muoto | Yhteensopivuus | Ominaisuudet |
|
||
------------------------------------ | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||
V1 (vanha versio) | Laiteohjelmisto 2.7.x ja vanhemmat | Raaka protobuf-koodaus portissa 72. Tukee vain sijainnin jakamista (PLI) ja keskusteluja (GeoChat) — muodot, merkinnät, reitit ja muut tyypitetyt CoT-tapahtumat jätetään välittämättä |
|
||
V2 (nykyinen) | Laiteohjelmisto 2.8.0+ | Pakkausmuoto käyttää zstd-pakkausta portissa 78. Tukee V1:n ominaisuuksien lisäksi myös muotoja, merkintöjä, reittejä, ilma-aluksia, lääkintäevakuointeja (CASEVAC), hätätilanteita ja tehtävätyyppisiä CoT-tapahtumia |
|
||
|
||
Radio välittää edelleen vanhojen radioiden V1-paketteja myös käyttäessään itse V2:ta, joten eri laiteohjelmistoversioita käyttävät mesh-verkot toimivat keskenään.
|
||
|
||
## Käyttö ATAK:n kanssa
|
||
|
||
Kun asetukset on määritetty:
|
||
|
||
- Meshtastic-radiot näkyvät ATAK-kartalla merkkeinä kutsutunnuksineen
|
||
- Viestit voivat välittyä mesh-verkon ja TAK-verkon välillä
|
||
- Sijaintipäivitykset kulkevat kaksisuuntaisesti Meshtasticin ja TAK-järjestelmän välillä
|
||
- TAK Tracker -radiot lähettävät PLI-sijaintia automaattisesti — niiden sijainti näkyy ATAK-kartoilla ilman erillistä ATAK-asetusta
|
||
|
||
> ℹ️ **Huomautus:** TAK-integraatio edellyttää tiettyjä radiorooleja. Tavalliset Client-roolin radiot eivät osallistu automaattisesti TAK-toimintoihin — mutta kun **Mesh to CoT Converter** on käytössä, ne näkyvät silti ATAK-kartalla yhteystietoina.
|
||
|
||
## Vianetsintä
|
||
|
||
Ongelma | Syy | Ratkaisu |
|
||
-------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||
Radio ei näy ATAK-kartalla | 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** |
|
||
Sijaintipäivitykset ovat vanhentuneita | GPS-signaali katkennut tai lähetysväli liian pitkä | Tarkista GPS-tila; lyhennä sijaintilähetyksen väliä kohdassa Sijainnin asetukset |
|
||
ATAK näyttää tilan "Ei yhteyttä" | Paikallinen TAK-palvelin ei ole käytössä tai ATAK on yhdistetty muualle | Varmista, että **Ota paikallinen TAK-palvelin käyttöön** on käytössä ja että ATAK muodostaa yhteyden osoitteeseen `127.0.0.1:8089` — tuo viety datapaketti uudelleen, jos et ole varma |
|
||
Muotoja, merkintöjä tai reittejä ei välitetä | Lähettävä radio käyttää vanhaa V1-protokollaa (laiteohjelmisto 2.7.x tai vanhempi) | Päivitä lähettävän radion laiteohjelmisto versioon 2.8.0 tai uudempaan, jotta V2-siirtomuoto on käytettävissä |
|
||
CoT-data ei kulje | Kanava ei täsmää | Kaikkien TAK-laitteiden täytyy olla samalla kanavalla ja yhteensopivalla salauksella |
|
||
|
||
## Tietoturvahuomiot
|
||
|
||
> 🔒 **Tietosuoja:** TAK-tiedot sisältävät sijaintisi ja kutsutunnuksesi. TAK-moduuli käyttää samaa kanavasalausta kuin muutkin Meshtastic-viestit — arkaluonteisissa ympäristöissä käytä kanavaa, jonka avain ei ole oletusarvoinen.
|
||
|
||
## Aiheeseen liittyvät aiheet
|
||
|
||
- [Asetukset — Moduulit ja ylläpito](settings-module-admin) — TAK-moduulin asetukset
|
||
- [Radiot](nodes) — TAK- ja TAK Tracker -roolit radiolistassa
|
||
- [Kartta ja reittipisteet](map-and-waypoints) — radioiden sijainnit kartalla
|
||
</pre>
|
||
</body>
|
||
</html> |