Meshtastic-Android/docs/fi-rFI/user/mqtt.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>MQTT</title>
  <link rel="stylesheet" href="../../styles/docs.css">
</head>
<body data-page="mqtt" data-locale="fi-rFI">
<pre class="markdown-content"># MQTT

MQTT yhdistää Meshtastic-mesh-verkkosi internetiin ja mahdollistaa pitkän kantaman viestinnän radioalueen ulkopuolella.

## Yleiskatsaus

MQTT-moduuli yhdistää radion MQTT-välityspalvelimeen, mahdollistaen:

- Viestien välittymisen eri fyysisten mesh-verkkojen välillä internetin kautta
- Integraation kotiautomaatio- ja valvontajärjestelmiin
- Radioiden sijaintien julkaisemisen julkiseen Meshtastic-karttaan
- Mukautetut dataputket tiedonkeruuta ja hälytyksiä varten

## Kuinka se toimii

```
[Oma radiot] → Radio → Gateway-radio WiFi:llä → MQTT-välityspalvelin → Etä-gateway → Radio → Etä-radio
```

Internet-yhteydellinen gateway-radio (WiFi tai Ethernet) julkaisee mesh-viestit MQTT-aiheeseen. Etä-yhdyskäytävät, jotka ovat tilanneet saman aiheen, syöttävät viestit omaan paikalliseen mesh-verkkoonsa.

## Asetukset

### MQTT:n käyttöönotto

1. Siirry kohtaan **Asetukset → Moduulin asetukset → MQTT**.
2. Ota MQTT-moduuli käyttöön.
3. Määritä välityspalvelimen yhteys:

![MQTT kytkin](../../assets/screenshots/settings_switch.png)

 Asetus            | Kuvaus                                                                                                | Oletus                                              |
 ----------------- | ----------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
 Palvelimen osoite | MQTT-välityspalvelimen osoite                                                                         | mqtt.meshtastic.org |
 Käyttäjänimi      | Välityspalvelimen tunnistautuminen                                                                    | meshdev                                             |
 Salasana          | Välityspalvelimen tunnistautuminen                                                                    | large4cats                                          |
 Juuriaihe         | Viestien perusaihe                                                                                    | msh                                                 |
 Salaus            | MQTT-viestisisällön salaus                                                                            | Käytössä                                            |
 ~~JSON Output~~   | ⚠️ **Poistettu käytöstä** — JSON-pakettituki on poistettu firmwaresta; tämä kenttä jätetään huomiotta | Ei käytössä                                         |
 TLS               | Yhteyden suojaaminen välityspalvelimeen                                                               | Ei käytössä                                         |
 Karttaraportointi | Sijainnin julkaisu julkiselle kartalle                                                                | Ei käytössä                                         |

### MQTT-välityspalvelin tässä puhelimessa

Jos radiollasi ei ole omaa internetyhteyttä, se voi käyttää yhdistettyä puhelinta MQTT-yhdyskäytävänään. Ota käyttöön **MQTT** ja **Proxy to client enabled** moduulin asetuksista, jolloin sovellus välittää MQTT-liikenteen radion ja välityspalvelimen välillä puhelimen internetyhteyden kautta.

MQTT-asetusten yläreunassa oleva **MQTT-välityspalvelin tässä puhelimessa** -kytkin näyttää, onko tämä välitys käytössä, ja sen avulla voit poistaa sen käytöstä (tai käynnistää sen uudelleen) heti ilman, että laitteen MQTT-asetuksia tarvitsee muokata ja tallentaa uudelleen.

### Oletus Meshtastic-välityspalvelin

Yhteisö ylläpitää julkista välityspalvelinta osoitteessa `mqtt.meshtastic.org`. Tämä on tarkoitettu yleiseen käyttöön ja testaukseen.

&gt; ℹ️ **Huomautus:** Yhteydet palvelimeen `mqtt.meshtastic.org` käyttävät aina TLS-salausta (portti 8883), vaikka TLS-kytkin olisi poistettu käytöstä. Kaikkien muiden välityspalvelimien kohdalla TLS-salausta käytetään vain, kun otat sen käyttöön (TLS:llä portti 8883, ilman TLS:ää portti 1883).

&gt; 🔒 **Tietosuoja:** Julkisen välityspalvelimen viestit ovat kaikkien tilaajien luettavissa. Käytä aina kanavasalausta yksityiseen viestintään.

### Oma välityspalvelin

Parempaa yksityisyyttä ja hallintaa varten voit käyttää omaa MQTT-välityspalvelinta:

- Mosquitto (kevyt, avoimen lähdekoodin)
- HiveMQ
- EMQX

Määritä radiosi osoittamaan omaan välityspalvelimeesi oikeilla tunnistetiedoilla.

## Karttaraportointi

Kun karttajako (Map Reporting) on käytössä, radiosi julkaisee sijaintinsa Meshtastic-yhteisökartalle:

- Näkyvissä osoitteessa [meshmap.net](https://meshmap.net) ja vastaavissa yhteisökarttapalveluissa
- Jaetaan vain sijainti- ja laitetiedot
- Poista käytöstä, jos et halua sijaintisi näkyvän julkisesti

## Lähetys vs vastaanotto

 Suunta          | Kuvaus                                           |
 --------------- | ------------------------------------------------ |
 **Lähetys**     | Viestit mesh-verkosta → MQTT-välityspalvelimeen  |
 **Vastaanotto** | Viestit MQTT-välityspalvelimesta → mesh-verkkoon |

Määritä kanavakohtaisesti, mitkä suunnat ovat käytössä viestiliikenteen ja lähetysajan käytön hallintaan.

## Viestiformaatit

MQTT käyttää protobuf-viestimuotoa:

 Muoto        | Kuvaus                                    | Käyttötarkoitus                |
 ------------ | ----------------------------------------- | ------------------------------ |
 **Protobuf** | Binäärinen Meshtastic protobuf -enkoodaus | Radioiden välinen mesh-siltaus |

&gt; ⚠️ **Huom:** JSON-ulostulotuki on poistettu firmwaresta. `json_enabled`-asetus näkyy yhä sovelluksessa taaksepäinyhteensopivuuden vuoksi, mutta sillä ei ole vaikutusta nykyisissä firmware-versioissa.

## Salaus ja yksityisyys

Kerrostetun salausmallin ymmärtäminen:

1. **Kanavasalaus** tapahtuu meshissä _ennen_ MQTT:tä. Jos kanavallasi on PSK, MQTT-viestisisältö on jo salattu — välityspalvelin ja tilaajat näkevät vain salatun datan.
2. **MQTT-salaus** (moduuliasetus) lisää ylimääräisen salauskerroksen matkalla välityspalvelimelle. Tämä suojaa metatietoja ja reititystietoja.
3. **TLS** salaa TCP-yhteyden itse välityspalvelimeen estäen verkkotason salakuuntelun.

&gt; 🔒 **Tärkeää:** julkisella oletuskanavalla on tunnettu avain. Oletuskanavan MQTT:n kautta lähetetyt viestit ovat käytännössä **salaamattomia** — kuka tahansa tilaaja voi purkaa ne. Käytä aina omaa PSK-avainta yksityiseen viestintään.

## Parhaat käytännöt

- Käytä kanavatasoista salausta (PSK) kanavissa, jotka yhdistetään MQTT:hen
- Älä ota MQTT:tä käyttöön laitteissa, joilla ei ole internet-yhteyttä (se puskuroidaan ja kuluttaa muistia)
- Käytä yksityistä välityspalvelinta arkaluonteisissa käyttöönotossa
- Ole tarkkana lähetysajan (downlink) käyttämisessä ruuhkaisissa MQTT-aiheissa — jokainen viesti kuluttaa radio-aikaa paikallisessa meshissä
- Harkitse lähetyssuunnan vaihtamista (uplink), jos haluat vain seurata verkkoa etänä ilman viestien lähettämistä verkkoon

## Vianetsintä

### MQTT ei yhdistä

- Tarkista WiFi — yhdyskäytävän radiolla täytyy olla aktiivinen internet-yhteys (WiFi tai Ethernet). MQTT ei toimi LoRa-radiolinkin kautta.
- Tarkista tunnukset — väärä käyttäjänimi tai salasana epäonnistuu useimmilla välityspalvelimilla hiljaisesti Tarkista ylimääräiset välilyönnit
- Palomuuri — portti 1883 (MQTT) tai 8883 (MQTT+TLS) täytyy olla auki. Jotkin verkot estävät ei-standardit portit.
- **DNS-ratkaisu** – jos käytät omaa välityspalvelimen isäntänimeä, varmista että laite pystyy ratkaisemaan sen. Kokeile välityspalvelimen IP-osoitetta suoraan.

### Viestit eivät välity

- **Tarkista lähetys ja vastaanotto-asetukset** – jos vain lähetys on käytössä, viestit kulkevat meshistä MQTT:hen mutta eivät takaisin. Ota vastaanotto käyttöön vastaanottavassa yhdyskäytävän laitteessa.
- **Kanava ei täsmää** – molempien gateway-laitteiden täytyy käyttää samaa kanavaa ja samaa PSK-avainta. Eroavaisuus tarkoittaa, että viestit on salattu eri avaimilla ja näyttävät roskalta.
- **Aihe ei täsmää** – varmista, että molemmat yhdyskäytävät käyttävät samaa juuriaihetta (Root Topic). Oletus `msh` toimii julkisessa välityspalvelimessa.

## Aiheeseen liittyvät aiheet

- [Asetukset — Moduulit ja ylläpito](settings-module-admin) — MQTT-moduulin asetusten viite
- [Viestit ja kanavat](messages-and-channels) — kanavasalaus ja PSK-asetukset
- [MQTT-integraatio-opas](https://meshtastic.org/docs/software/integrations/mqtt) — yksityiskohtainen MQTT-dokumentaatio meshtastic.org -sivustolla

---

</pre>
</body>
</html>