🌐 Suomi — Community translation View in English

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

⚠️ 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:

Paikallisen TAK-palvelimen asetukset, joissa näkyvät käyttöönotto ja vientitoiminto

  • 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
  • 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

ℹ️ 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