Versie van 3 okt 2025 20:39

Uitleg over MQTT

Standaard is deze module uitgeschakeld.

Wanneer de node met WiFi of Ethernet verbonden is, dan kun je wanneer MQTT ingesteld en ingeschakeld is pakketten doorsturen naar de ingestelde MQTT-Server. Hierdoor kunnen gebruikers op het lokale mesh communiceren met gebruikers op internet. Een of meer kanalen moeten ook worden ingeschakeld als uplink en/of downlink om pakketten van en/of naar uw mesh te verzenden. Wanneer u berichten via MQTT wilt verzenden en ontvangen, dient dit onder "kanalen" te worden ingesteld, standaard worden alleen statusberichten van uw node via MQTT gedeeld.

`De in deze kleur getoonde teksten zijn bedoeld voor gebruik in combinatie met de MQTT Server (broker) van MeshNet.`

Wacht met het inschakelen van MQTT enabled en vul eerst onderstaande gegevens in, alles ingevuld? Doorloop alles nog even en schakel bovenin MQTT in en klik op, "opslaan".

MQTT Instellingen voor de MeshNet / DutchMesh MQTT Broker ( MeshNet /PA8F)

Server Address (url:poort) mqtt.meshnet.nl of mqtt.pa8f.nl

De server die gebruikt moet worden voor MQTT. Indien niet ingesteld, wordt de standaard openbare server gebruikt. De standaard poort indien niet ingevuld is 1883. Wanneer TLS word ingeschakeld moet deze worden gewijzigd naar 8883 url:8883.

Username: boreft

Gebruikersnaam van de MQTT-server die moet worden gebruikt.

Password: meshboreft

Te gebruiken MQTT-wachtwoord.

Encryption enabled: ingeschakeld

Of er gecodeerde of niet-gecodeerde pakketten naar MQTT moeten worden verzonden.

Let op: Als deze optie niet is ingeschakeld, worden alle berichten ongecodeerd via de MQTT-broker verzonden, zelfs als er coderingssleutels zijn ingesteld voor uw uplinkkanalen. Met het oog op privacy zeker niet onverstandig, tegenwoordig gebruiken steeds meer nodes encryptie. Zonder encryptie werkt het versturen van privé berichten (via MQTT) meestal niet meer.

JSON output enabled: uitgeschakeld

Schakel het verzenden/verbruiken van JSON-pakketten op MQTT in. Deze pakketten zijn niet gecodeerd, maar bieden een eenvoudige manier om te integreren met systemen die JSON kunnen lezen.

TLS enabled: uitgeschakeld

Als deze ingeschakeld is wordt er een beveiligde verbinding opgezet met de MQTT server met TLS encryptie (poort 8883).

Root topic: msh/{postcode-reeks}

Het root-onderwerp dat moet worden gebruikt voor MQTT-berichten. Dit is handig als u één MQTT-server wilt gebruiken voor meerdere meshtastische netwerken en deze wilt scheiden via ACL's.

Proxy to client (optioneel)

Schakel deze in wanneer u verbinding wilt maken met een MQTT-Server via uw smartphone, schakel deze uit wanneer uw node verbinding maakt met het internet via WiFi of Ethernet.

Map reporting (optioneel)

Beschikbaar vanaf firmwareversie 2.3.2. Wanneer deze ingeschakeld is, stuurt uw node periodiek een ongecodeerd kaartrapport naar de MQTT-server om te worden weergegeven door online kaarten die dit pakket ondersteunen. Dit rapport bevat de volgende informatie:

De lange en korte naam en ID van het knooppunt;
De positie van het knooppunt (met instelbare precisie) en de hoogte;
Het hardware model en de rol van het knooppunt ;
De firmwareversie van het knooppunt;
De LoRa-regio van het knooppunt, de modemvoorinstelling en de naam van het primaire kanaal;
Of het knooppunt bereikbaar is op het standaardkanaal met de bekende sleutel;
Aantal lokale online knooppunten (gehoord in de laatste 2 uur, exclusief die gehoord via MQTT).

@@ Regel 9: / Regel 9: @@
 `De in deze kleur getoonde teksten zijn bedoeld voor gebruik in combinatie met de MQTT Server (broker) van MeshNet.`
-Wacht met het inschakelen van MQTT en vul eerst onderstaande gegevens in, alles ingevuld? Doorloop alles nog even en schakel bovenin MQTT in en klik op, "opslaan".
+Wacht met het inschakelen van <code>MQTT enabled</code> en vul eerst onderstaande gegevens in, alles ingevuld? Doorloop alles nog even en schakel bovenin MQTT in en klik op, "opslaan".
-== MQTT Instellingen voor de MeshNet / DutchMesh MQTT Broker ( PA8F / MeshNet ) ==
+== MQTT Instellingen voor de MeshNet / DutchMesh MQTT Broker ( MeshNet /PA8F) ==
-'''Server Address''': mqtt.meshnet.nl of mqtt.pa8f.nl
+'''Server Address (url:poort)''' <code>mqtt.meshnet.nl</code> of <code>mqtt.pa8f.nl</code>
-''De server die gebruikt moet worden voor MQTT. Indien niet ingesteld, wordt de standaard openbare server gebruikt.''
+''De server die gebruikt moet worden voor MQTT. Indien niet ingesteld, wordt de standaard openbare server gebruikt. De standaard poort indien niet ingevuld is 1883. Wanneer TLS word ingeschakeld moet deze worden gewijzigd naar 8883 <code>url:8883</code>''.
-'''Username''': boreft
+'''Username''': <code>boreft</code>
 ''Gebruikersnaam van de MQTT-server die moet worden gebruikt.''
-'''Password''': meshboreft
+'''Password''': <code>meshboreft</code>
 ''Te gebruiken MQTT-wachtwoord.''
-'''Encryption Enabled''': Ingeschakeld
+'''Encryption enabled''': <code>ingeschakeld</code>
 ''Of er gecodeerde of niet-gecodeerde pakketten naar MQTT moeten worden verzonden.''
@@ Regel 31: / Regel 31: @@
 Let op: Als deze optie niet is ingeschakeld, worden alle berichten ongecodeerd via de MQTT-broker verzonden, zelfs als er coderingssleutels zijn ingesteld voor uw uplinkkanalen. Met het oog op privacy zeker niet onverstandig, tegenwoordig gebruiken steeds meer nodes encryptie. Zonder encryptie werkt het versturen van privé berichten (via MQTT) meestal niet meer.
-'''JSON''': disabled
+'''JSON output enabled:''' <code>uitgeschakeld</code>
 ''Schakel het verzenden/verbruiken van JSON-pakketten op MQTT in. Deze pakketten zijn niet gecodeerd, maar bieden een eenvoudige manier om te integreren met systemen die JSON kunnen lezen.''
-'''TLS''': disabled
+'''TLS enabled''': <code>uitgeschakeld</code>
-''Als deze ingeschakeld is, dan wordt geprobeerd een beveiligde verbinding tot stand te brengen via TLS (port 8883).''
+''Als deze ingeschakeld is wordt er een beveiligde verbinding opgezet met de MQTT server met TLS encryptie (poort 8883).''
-'''Root Topic''': msh/{postcode-reeks}
+'''Root topic''': <code>msh/{postcode-reeks}</code>
 ''Het root-onderwerp dat moet worden gebruikt voor MQTT-berichten. Dit is handig als u één MQTT-server wilt gebruiken voor meerdere meshtastische netwerken en deze wilt scheiden via ACL's.''
-'''Client Proxy Enabled''' optioneel
+'''Proxy to client''' (optioneel)
 ''Schakel deze in wanneer u verbinding wilt maken met een MQTT-Server via uw smartphone, schakel deze uit wanneer uw node verbinding maakt met het internet via WiFi of Ethernet.''
-'''Map Reporting Enabled''' optioneel
+'''Map reporting ('''optioneel)
 Beschikbaar vanaf firmwareversie 2.3.2. Wanneer deze ingeschakeld is, stuurt uw node periodiek een ongecodeerd kaartrapport naar de MQTT-server om te worden weergegeven door online kaarten die dit pakket ondersteunen. Dit rapport bevat de volgende informatie:
@@ Regel 53: / Regel 53: @@
 * De lange en korte naam en ID van het knooppunt;
 * De positie van het knooppunt (met instelbare precisie) en de hoogte;
-* Het hardwaremodel en de rol van het knooppunt ;
+* Het hardware model en de rol van het knooppunt ;
 * De firmwareversie van het knooppunt;
 * De LoRa-regio van het knooppunt, de modemvoorinstelling en de naam van het primaire kanaal;