Meshtastic-opas - Meshtastic MQTT -moduulin määritys

Jos laitteesi on yhdistetty Internetiin Wi-Fi:n tai Ethernetin kautta, voit ottaa käyttöön pakettien välittämisen MQTT-palvelimelle. Tämä mahdollistaa paikallisen mesh-verkon käyttäjien viestinnän Internetin käyttäjien kanssa. Yksi tai useampi kanava on myös otettava käyttöön ylälinkkinä ja/tai alalinkkinä, jotta paketit voidaan lähettää mesh-verkostasi ja/tai vastaanottaa siihen (katso kanavat).

MQTT-moduulin kokoonpanoasetuksiin kuuluvat: Käytössä, Palvelimen osoite, Käyttäjätunnus, Salasana, Salaus käytössä, JSON käytössä, TLS käytössä, Juuri-aihe, Asiakasproksin käyttö, Karttaraportointi käytössä (paikkatarkkuudella ja julkaisuvälillä) sekä Okay to MQTT. MQTT-moduulin kokoonpano käyttää ylläpitäjäviestiä, joka lähettää ConfigModule.MQTT protobufin.

MQTT-moduulin kokoonpanoarvot

Käytössä: Ottaa MQTT-moduulin käyttöön.
Palvelimen osoite: Käytettävä palvelin MQTT:lle. Jos sitä ei ole asetettu, käytetään oletusjulkista palvelinta.
Käyttäjätunnus: Käytettävä MQTT-palvelimen käyttäjätunnus (erityisen hyödyllinen mukautetulle MQTT-palvelimelle). Jos käytät mukautettua palvelinta, tämä otetaan huomioon, vaikka se olisi tyhjä. Jos käytät oletusjulkista palvelinta, se otetaan huomioon vain, jos se on asetettu; muuten laite käyttää oletuskäyttäjätunnusta.
Salasana: Käytettävä MQTT-salasana (erityisen hyödyllinen mukautetulle MQTT-palvelimelle). Jos käytät mukautettua palvelinta, tämä otetaan huomioon, vaikka se olisi tyhjä. Jos käytät oletuspalvelinta, se otetaan huomioon vain, jos se on asetettu; muuten laite käyttää oletussalasanaa.
Salaus käytössä: Voit määrittää, lähetetäänkö salattuja vai salattomia paketteja MQTT-palvelimelle. Salattomat paketit voivat olla hyödyllisiä ulkoisille järjestelmille, jotka haluavat vastaanottaa Meshtastic-paketteja. Huomautus: Kaikki viestit lähetetään MQTT-välittäjälle salattomina, jos tätä asetusta ei ole otettu käyttöön, vaikka ylälinkkikanavillasi olisi asetettu salausavaimia.
JSON käytössä: JSON ei ole tuettu nRF52-alustalla. Voit ottaa käyttöön JSON-pakettien lähetyksen ja vastaanoton MQTT:ssä. Nämä paketit eivät ole salattuja, mutta tarjoavat helpon tavan integroitua järjestelmiin, jotka voivat lukea JSONia.
TLS käytössä: Jos asetettu true, yritämme muodostaa suojatun yhteyden käyttäen TLS:ää.
Juuri-aihe: Juuri-aiheen valinta MQTT-viesteille on tärkeää. Tämä on hyödyllistä, jos haluat käyttää yhtä MQTT-palvelinta useille Meshtastic-verkoille ja erottaa ne ACL:ien avulla.
Asiakasvälityspalvelin käytössä: Jos asetettu true, laite käyttää asiakkaan (esim. puhelimesi) verkkoyhteyttä yhdistääkseen MQTT-palvelimeen. Jos asetettu false, se käyttää laitteen omaa verkkoyhteyttä, joka on otettava käyttöön verkkasetuksista.

Karttaraportointi käytössä

Saatavilla laiteohjelmistoversiosta 2.3.2 eteenpäin. Jos asetettu true, solmusi lähettää säännöllisesti salaamattoman karttaraportin MQTT-palvelimelle näytettäväksi online-kartoilla, jotka tukevat tätä pakettia. Tämä raportti sisältää seuraavat tiedot:

Solmun pitkä ja lyhyt nimi sekä ID
Solmun sijainti (määritettävällä tarkkuudella) ja korkeus
Solmun laitteistomalli ja rooli
Solmun laiteohjelmistoversion tiedot
Solmun LoRa-alue, modeemin esiasetus ja ensisijaisen kanavan nimi
Voiko solmuun ottaa yhteyttä oletuskanavalla tunnetulla avaimella
Paikallisten online-solmujen määrä (kuultu viimeisen 2 tunnin aikana, pois lukien ne, jotka on kuultu MQTT:n kautta)

Karttaraportin sijainnin tarkkuus viittaa karttaraportin sijainnin tarkkuuteen, oletusarvoisella enimmäispoikkeamalla noin 1459 m.

Karttaraportin julkaisuväli määrittää, kuinka usein karttaraportti julkaistaan MQTT-palvelimelle sekunteina, oletusasetuksena on 900 sekuntia (15 minuuttia).

MQTT-moduulin määritysasiakas

Android

MQTT-asetukset ovat saatavilla Androidille.

avaa Meshtastic-sovellus
Siirry kohtaan: Vertikaalinen Ellipsi (3 pistettä oikeassa yläkulmassa) > Radioasetukset > MQTT.

Omena

Kaikki MQTT asetukset ovat käytettävissä iOS:ssa, iPadOS:ssa ja macOS:ssa. Niihin pääsee siirtymällä: Asetukset > Moduulin asetukset > MQTT.

CLI

Seuraavat asetukset ovat käytettävissä Python CLI:ssä:

Asetus	Hyväksyttävät arvot	Oletus
mqtt.enabled	true, false	FALSE
mqtt.address	string	mqtt.meshtastic.org
mqtt.username	string	meshdev
mqtt.password	string	large4cats
mqtt.encryption_enabled	true, false	FALSE
mqtt.json_enabled	true, false	FALSE
mqtt.tls_enabled	true, false	FALSE
mqtt.root	string
mqtt.proxy_to_client_enabled	true, false	FALSE
mqtt.map_reporting_enabled	true, false	FALSE

Ota MQTT-moduuli käyttöön/poista käytöstä

meshtastic --set mqtt.enabled true meshtastic --set mqtt.enabled false

Ota MQTT JSON käyttöön/poista käytöstä

meshtastic --set mqtt.json_enabled true meshtastic --set mqtt.json_enabled false

HUOM: Koska laite käynnistyy uudelleen jokaisen CLI:n kautta lähetetyn komennon jälkeen, on suositeltavaa ketjuttaa komennot yhdeksi, kun asetetaan useita arvoja asetuskohdassa. Esimerkiksi:

meshtastic --set mqtt.enabled true --set mqtt.json_enabled true

Verkko

Kaikki MQTT moduulin asetukset ovat käytettävissä Web UI:ssa.

Pääsy oletusarvoiselle julkiselle palvelimelle

Android

Ota MQTT-moduuli käyttöön

Siirry kohtaan: Vertikaalinen Ellipsi (3 pistettä oikeassa yläkulmassa) > Radioasetukset > MQTT: Ota käyttöön liukusäädin kohdassa MQTT enabled ja napauta Lähetä.

Valinnainen: Käyttääksesi puhelimesi internet-yhteyttä pakettien lähettämiseen ja vastaanottamiseen verkon yli, ota myös käyttöön liukusäädin kohdassa MQTT Client Proxy ja ohita alla oleva Verkkoasetusten määrittäminen -vaihe.

Ota kanavan ylä- ja alayhteys käyttöön

Siirry kohtaan: Vertikaalinen Ellipsi (3 pistettä oikeassa yläkulmassa) > Radioasetukset > Kanavat > LongFast: Ota käyttöön liukusäätimet kohdissa Uplink enabled ja Downlink enabled, napauta sitten Tallenna ja napauta Lähetä.

Määritä verkkoyhteydet

Siirry kohtaan: Vertical Ellipsis (3 pistettä oikeassa yläkulmassa) > Radio Configuration > Network: Kytke WiFi enabled -liukusäädin päälle, syötä verkon SSID ja PSK, ja napauta Send.

Omena

Ota MQTT-moduuli käyttöön Siirry kohtaan Settings > MQTT: Kytke MQTT enabled -kytkin ON-asentoon ja napauta Tallenna.

Valinnainen: Jos haluat käyttää puhelimesi internet-yhteyttä pakettien lähettämiseen ja vastaanottamiseen verkossa, ota myös MQTT Client Proxy -kytkin käyttöön ja ohita alla oleva Configure Network Settings -vaihe.

Ota kanavan ylä- ja alayhteys käyttöön Siirry kohtaan Settings > Channels > Primary Channel: Kytke Uplink enabled ja Downlink enabled -kytkimet ON-asentoon, ja napauta Tallenna.

Määritä verkkoyhteydet Siirry kohtaan Settings > Network: Kytke WiFi enabled -kytkin ON-asentoon, syötä verkon SSID ja PSK, ja napauta Tallenna.

CLI

Ota MQTT-moduuli käyttöön

meshtastic --set mqtt.enabled true

Ota kanavan ylä- ja alayhteys käyttöön

meshtastic --ch-set uplink_enabled true --ch-index 0 meshtastic --ch-set downlink_enabled true --ch-index 0

tai ketjutettuna:

meshtastic --ch-set uplink_enabled true --ch-index 0 --ch-set downlink_enabled true --ch-index 0

Määritä verkkoyhteydet

meshtastic --set network.wifi_enabled true meshtastic --set network.wifi_ssid "your network" meshtastic --set network.wifi_psk yourpassword

tai ketjutettuna:

meshtastic --set network.wifi_enabled true --set network.wifi_ssid "your network" --set network.wifi_psk yourpassword

Verkko

Ota MQTT-moduuli käyttöön Siirry kohtaan Config > Module Config > MQTT - Kytke MQTT enabled -kytkin ON-asentoon - Napsauta Tallenna-kuvaketta.

Valinnainen: Jos haluat käyttää asiakkaasi internet-yhteyttä pakettien lähettämiseen ja vastaanottamiseen verkossa, ota myös Proxy to Client Enabled -liukusäädin käyttöön ja ohita alla oleva Configure Network Settings -vaihe.

HUOM: Vaikka tämä vaihtoehto saattaa näkyä käyttöliittymässäsi, Client Proxy ei ole tällä hetkellä toiminnassa Web Clientin kanssa.

Ota kanavan ylä- ja alayhteys käyttöön Siirry kohtaan Channels > Primary: Kytke Uplink Enabled- ja Downlink Enabled -kytkimet ON-asentoon - Napsauta Tallenna-kuvaketta.

Määritä verkkoyhteydet Siirry kohtaan Radio Config > Device > Network: Kytke Enabled-kytkin ON-asentoon, syötä verkon SSID ja PSK, ja napsauta Tallenna-kuvaketta.