Guide Meshtastic - Configuration du module MQTT Meshtastic

Si votre appareil est connecté à Internet via Wi-Fi ou Ethernet, vous pouvez l'activer pour qu'il transmette les paquets à un serveur MQTT. Cela permet aux utilisateurs du maillage local de communiquer avec les utilisateurs sur Internet. Un ou plusieurs canaux doivent également être activés en tant que liaison montante et/ou descendante pour que les paquets soient transmis depuis et/ou vers votre maillage (voir canaux).

Les options de configuration du module MQTT incluent : Activé, Adresse du serveur, Nom d'utilisateur, Mot de passe, Chiffrement activé, JSON activé, TLS activé, Sujet racine, Proxy client activé, Rapport de carte activé (avec précision de position et intervalle de publication), et Autorisé à MQTT. La configuration du module MQTT utilise un message admin qui envoie un protobuf ConfigModule.MQTT.

Valeurs de configuration du module MQTT

Activé : Active le module MQTT.
Adresse du serveur : Le serveur à utiliser pour MQTT. Si non défini, le serveur public par défaut sera utilisé.
Nom d'utilisateur : Le nom d'utilisateur du serveur MQTT à utiliser (le plus utile pour un serveur MQTT personnalisé). Si vous utilisez un serveur personnalisé, ce nom sera pris en compte même s'il est vide. Si vous utilisez le serveur public par défaut, il ne sera pris en compte que s'il est défini ; sinon, l'appareil utilisera le nom d'utilisateur par défaut.
Mot de passe : Le mot de passe MQTT à utiliser (le plus utile pour un serveur MQTT personnalisé). Si vous utilisez un serveur personnalisé, ce mot de passe sera pris en compte même s'il est vide. Si vous utilisez le serveur par défaut, il ne sera pris en compte que s'il est défini ; sinon, l'appareil utilisera le mot de passe par défaut.
Chiffrement activé : Il est possible de configurer l'envoi de paquets chiffrés ou non chiffrés au serveur MQTT. Les paquets non chiffrés peuvent être utiles pour les systèmes externes qui souhaitent consommer les paquets Meshtastic. Note : Tous les messages sont envoyés au courtier MQTT non chiffrés si cette option n'est pas activée, même lorsque vos canaux montants ont des clés de chiffrement définies.
JSON activé : JSON n'est pas pris en charge sur la plateforme nRF52. Vous pouvez activer l'envoi et la consommation de paquets JSON sur MQTT. Ces paquets ne sont pas chiffrés mais offrent un moyen simple d'intégration avec des systèmes capables de lire le JSON.
TLS activé : Si réglé sur true, nous tenterons d'établir une connexion sécurisée en utilisant TLS.
Topic racine : Le topic racine à utiliser pour les messages MQTT est important. Cela est utile si vous souhaitez utiliser un seul serveur MQTT pour plusieurs réseaux Meshtastic et les séparer via des ACL.
Proxy client activé : Si réglé sur true, l'appareil utilisera la connexion réseau du client (par exemple, celle de votre téléphone) pour se connecter au serveur MQTT. Si réglé sur false, il utilisera la propre connexion réseau de l'appareil, qui doit être activée via les paramètres réseau.

Rapport de carte activé

Disponible à partir de la version du firmware 2.3.2 et suivantes, si réglé sur true, votre nœud enverra périodiquement un rapport de carte non chiffré au serveur MQTT pour affichage sur les cartes en ligne qui supportent ce paquet. Ce rapport inclut les informations suivantes :

Le nom long et court du nœud et son ID
La position du nœud (avec précision configurable) et son altitude
Le modèle matériel du nœud et son rôle
La version du firmware du nœud
La région LoRa du nœud, le préréglage du modem et le nom du canal principal
Si le nœud est accessible sur le canal par défaut avec une clé connue
Nombre de nœuds locaux en ligne (entendus au cours des 2 dernières heures, à l'exclusion de ceux entendus via MQTT)

Précision de la position du rapport de carte fait référence à la précision utilisée pour la position dans le rapport de carte, avec une déviation maximale par défaut d'environ 1459m.

Intervalle de publication du rapport de carte spécifie la fréquence à laquelle le rapport de carte doit être publié sur le serveur MQTT en secondes, avec une valeur par défaut de 900 secondes (15 minutes).

Configuration du client du module MQTT

Android

Les options de configuration MQTT sont disponibles pour Android.

ouvrez l'application Meshtastic
Naviguez vers : Ellipse verticale (3 points en haut à droite) > Configuration radio > MQTT.

Pomme

Toutes les options de config MQTT sont disponibles sur iOS, iPadOS et macOS. Pour y accéder, allez dans : Réglages > Configuration du module > MQTT.

CLI

Les options de configuration suivantes sont disponibles dans le CLI Python :

Paramètre	Valeurs acceptables	Par défaut
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

Activer/Désactiver le module MQTT

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

Activer/Désactiver MQTT JSON

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

REMARQUE : Comme l'appareil va redémarrer après chaque commande envoyée via le CLI, il est recommandé de chaîner les commandes en une seule lorsque vous définissez plusieurs valeurs dans une section de configuration. Par exemple :

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

Web

Toutes les options de config module MQTT sont disponibles pour l'interface Web.

Accéder au serveur public par défaut

Android

Activer le module MQTT

Naviguez vers : Ellipse verticale (3 points en haut à droite) > Configuration radio > MQTT : activez le curseur pour MQTT activé et appuyez sur Envoyer.

Optionnel : Pour utiliser la connexion internet de votre téléphone pour envoyer et recevoir des paquets via le web, activez également le curseur pour Proxy client MQTT et sautez l'étape Configurer les paramètres réseau ci-dessous.

Activer l'uplink et le downlink du canal

Naviguez vers : Ellipse verticale (3 points en haut à droite) > Configuration radio > Canaux > LongFast : activez les curseurs pour Uplink activé et Downlink activé, puis appuyez sur Enregistrer et sur Envoyer.

Configurer les paramètres réseau

Naviguez vers : Ellipse verticale (3 points en haut à droite) > Configuration radio > Réseau : activez le curseur pour WiFi activé, saisissez le SSID et le PSK de votre réseau, puis appuyez sur Envoyer.

Pomme

Activer le module MQTT Allez dans Settings > MQTT : Activez l'interrupteur MQTT enabled en position ON, puis appuyez sur Enregistrer.

Optionnel : Si vous souhaitez utiliser la connexion internet de votre téléphone pour envoyer et recevoir des paquets en ligne, activez également le toggle MQTT Client Proxy et passez l'étape Configurer les paramètres réseau ci-dessous.

Activer l'uplink et le downlink du canal Allez dans Settings > Channels > Primary Channel : Activez les interrupteurs Uplink enabled et Downlink enabled en position ON, puis appuyez sur Enregistrer.

Configurer les paramètres réseau Allez dans Settings > Network : Activez l'interrupteur WiFi enabled en position ON, puis saisissez votre SSID et PSK pour le réseau, et appuyez sur Enregistrer.

CLI

Activer le module MQTT

meshtastic --set mqtt.enabled true

Activer l'uplink et le downlink du canal

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

ou enchaînés :

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

Configurer les paramètres réseau

meshtastic --set network.wifi_enabled true meshtastic --set network.wifi_ssid "votre réseau" meshtastic --set network.wifi_psk votremotdepasse

ou enchaînés :

meshtastic --set network.wifi_enabled true --set network.wifi_ssid "votre réseau" --set network.wifi_psk votremotdepasse

Web

Activer le module MQTT Allez dans Config > Module Config > MQTT - Activez l'interrupteur MQTT enabled en position ON - Cliquez sur l'icône Enregistrer.

Optionnel : Si vous souhaitez utiliser la connexion internet de votre client pour envoyer et recevoir des paquets en ligne, activez également le curseur Proxy to Client Enabled et passez l'étape Configurer les paramètres réseau ci-dessous.

REMARQUE : Bien que cette option puisse être visible dans votre interface, le Client Proxy n'est actuellement pas opérationnel avec le Web Client.

Activer l'uplink et le downlink du canal Allez dans Channels > Primary : Activez les interrupteurs Uplink Enabled et Downlink Enabled en position ON - Cliquez sur l'icône Enregistrer.

Configurer les paramètres réseau Allez dans Radio Config > Device > Network : Activez l'interrupteur Enabled en position ON, saisissez votre SSID et PSK pour le réseau, puis cliquez sur l'icône Enregistrer.