Se il tuo dispositivo è connesso a Internet tramite Wi-Fi o Ethernet, puoi abilitarlo per inoltrare i pacchetti a un server MQTT. Questo permette agli utenti della mesh locale di comunicare con gli utenti su Internet. Uno o più canali devono anche essere abilitati come uplink e/o downlink affinché i pacchetti vengano trasmessi da e/o verso la tua mesh (vedi canali).
Le opzioni di configurazione del modulo MQTT includono: Abilitato, Indirizzo server, Nome utente, Password, Crittografia abilitata, JSON abilitato, TLS abilitato, Argomento root, Proxy client abilitato, Report mappa abilitato (con Precisione posizione e Intervallo di pubblicazione), e Okay to MQTT. La configurazione del modulo MQTT utilizza un messaggio admin che invia un protobuf ConfigModule.MQTT.
Valori di configurazione del modulo MQTT
-
Abilitato: Abilita il modulo MQTT.
-
Indirizzo server: Il server da utilizzare per MQTT. Se non impostato, verrà utilizzato il server pubblico predefinito.
-
Nome utente: Il nome utente del server MQTT da utilizzare (più utile per un server MQTT personalizzato). Se si utilizza un server personalizzato, questo verrà rispettato anche se vuoto. Se si utilizza il server pubblico predefinito, verrà rispettato solo se impostato; altrimenti, il dispositivo utilizzerà il nome utente predefinito.
-
Password: La password MQTT da utilizzare (più utile per un server MQTT personalizzato). Se si utilizza un server personalizzato, questa verrà rispettata anche se vuota. Se si utilizza il server predefinito, verrà rispettata solo se impostata; altrimenti, il dispositivo utilizzerà la password predefinita.
-
Crittografia abilitata: È configurabile se inviare pacchetti crittografati o non crittografati al server MQTT. I pacchetti non crittografati possono essere utili per sistemi esterni che desiderano consumare i pacchetti Meshtastic. Nota: Tutti i messaggi vengono inviati al broker MQTT non crittografati se questa opzione non è abilitata, anche quando i tuoi canali uplink hanno impostate le chiavi di crittografia.
-
JSON Abilitato: JSON non è supportato sulla piattaforma nRF52. Puoi abilitare l'invio e il consumo di pacchetti JSON su MQTT. Questi pacchetti non sono criptati ma offrono un modo semplice per integrare sistemi che possono leggere JSON.
-
TLS Abilitato: Se impostato su true, tenteremo di stabilire una connessione sicura usando TLS.
-
Topic Radice: Il topic radice da usare per i messaggi MQTT è importante. Questo è utile se vuoi utilizzare un singolo server MQTT per più reti Meshtastic e separarli tramite ACL.
-
Proxy Client Abilitato: Se impostato su true, il dispositivo utilizzerà la connessione di rete del client (ad esempio, del tuo telefono) per connettersi al server MQTT. Se impostato su false, utilizzerà la connessione di rete del dispositivo, che deve essere abilitata tramite le impostazioni di rete.
Segnalazione Mappa Abilitata
Disponibile dalla versione firmware 2.3.2 in poi, se impostato su true, il tuo nodo invierà periodicamente un rapporto mappa non criptato al server MQTT per la visualizzazione su mappe online che supportano questo pacchetto. Questo rapporto include le seguenti informazioni:
-
Il nome lungo e corto del nodo e l'ID
-
La posizione del nodo (con precisione configurabile) e l'altitudine
-
Il modello hardware del nodo e il suo ruolo
-
La versione firmware del nodo
-
La regione LoRa del nodo, preset del modem e nome del canale primario
-
Se il nodo può essere raggiunto sul canale predefinito con una chiave nota
-
Numero di nodi locali online (sentiti nelle ultime 2 ore, escludendo quelli sentiti tramite MQTT)
Precisione della Posizione nel Rapporto Mappa si riferisce alla precisione usata per la posizione nel rapporto mappa, con una deviazione massima predefinita di circa 1459m.
Intervallo di Pubblicazione del Rapporto Mappa specifica la frequenza con cui il rapporto mappa deve essere pubblicato al server MQTT in secondi, con un'impostazione predefinita di 900 secondi (15 minuti).
Configurazione Client Modulo MQTT
Android
Le opzioni di Configurazione MQTT sono disponibili per Android.
-
apri la App Meshtastic
-
Naviga su: Ellissi Verticale (3 puntini in alto a destra) > Configurazione Radio > MQTT.
Mela
Tutte le opzioni di configurazione MQTT sono disponibili su iOS, iPadOS e macOS. Per accedervi, vai su: Impostazioni > Configurazione Modulo > MQTT.
CLI
Le seguenti opzioni di configurazione sono disponibili nella CLI Python:
| Impostazione | Valori Accettabili | Predefinito |
| 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 |
-
Abilita/Disabilita Modulo MQTT
meshtastic --set mqtt.enabled true meshtastic --set mqtt.enabled false
-
Abilita/Disabilita MQTT JSON
meshtastic --set mqtt.json_enabled true meshtastic --set mqtt.json_enabled false
NOTA: Poiché il dispositivo si riavvierà dopo ogni comando inviato tramite la CLI, si consiglia di concatenare i comandi in uno solo quando si impostano più valori in una sezione di configurazione. Per esempio:
meshtastic --set mqtt.enabled true --set mqtt.json_enabled true
Web
Tutte le opzioni di configurazione modulo MQTT sono disponibili per la Web UI.
Accedi al Server Pubblico Predefinito
Android
-
Abilita il modulo MQTT
Naviga su: Ellissi Verticale (3 puntini in alto a destra) > Configurazione Radio > MQTT: Attiva il cursore per MQTT abilitato e tocca Invia.
Opzionale: Per usare la connessione internet del tuo telefono per inviare e ricevere pacchetti via web, abilita anche il cursore per MQTT Client Proxy e salta il passaggio Configura Impostazioni Rete qui sotto.
-
Abilita Uplink e Downlink del canale
Naviga su: Ellissi Verticale (3 puntini in alto a destra) > Configurazione Radio > Canali > LongFast: Attiva i cursori per Uplink abilitato e Downlink abilitato, quindi tocca Salva e poi Invia.
-
Configura le impostazioni di rete
Naviga su: Ellissi Verticale (3 puntini in alto a destra) > Configurazione Radio > Rete: Attiva il cursore per WiFi abilitato, inserisci il SSID e la PSK della tua rete, quindi tocca Invia.
Mela
-
Attiva il modulo MQTT Vai a Settings > MQTT: Attiva l'interruttore MQTT enabled su ON e poi tocca Salva.
Opzionale: Se vuoi usare la connessione internet del tuo telefono per inviare e ricevere pacchetti online, abilita anche il toggle MQTT Client Proxy e bypassa il passaggio Configura le impostazioni di rete qui sotto.
-
Attiva Uplink e Downlink del canale Vai a Settings > Channels > Primary Channel: Attiva gli interruttori Uplink enabled e Downlink enabled su ON, poi tocca Salva.
-
Configura le impostazioni di rete Vai a Settings > Network: Attiva l'interruttore WiFi enabled su ON, poi inserisci il tuo SSID e PSK per la rete, e tocca Salva.
CLI
-
Abilita il modulo MQTT
meshtastic --set mqtt.enabled true
-
Abilita Uplink e Downlink del canale
meshtastic --ch-set uplink_enabled true --ch-index 0 meshtastic --ch-set downlink_enabled true --ch-index 0
o concatenati insieme:
meshtastic --ch-set uplink_enabled true --ch-index 0 --ch-set downlink_enabled true --ch-index 0
-
Configura le impostazioni di rete
meshtastic --set network.wifi_enabled true meshtastic --set network.wifi_ssid "your network" meshtastic --set network.wifi_psk yourpassword
o concatenati insieme:
meshtastic --set network.wifi_enabled true --set network.wifi_ssid "your network" --set network.wifi_psk yourpassword
Web
-
Attiva il modulo MQTT Vai a Config > Module Config > MQTT - Attiva l'interruttore MQTT enabled su ON - Clicca sull'icona Salva.
Opzionale: Se vuoi usare la connessione internet del tuo client per inviare e ricevere pacchetti online, abilita anche il cursore Proxy to Client Enabled e salta il passaggio Configura le impostazioni di rete qui sotto.
NOTA: Anche se questa opzione potrebbe essere visibile nella tua UI, il Client Proxy non è attualmente operativo con il Web Client.
-
Attiva Uplink e Downlink del canale Vai a Channels > Primary: Attiva gli interruttori per Uplink Enabled e Downlink Enabled su ON - Clicca sull'icona Salva.
-
Configura le impostazioni di rete Vai a Radio Config > Device > Network: Attiva l'interruttore Enabled su ON, inserisci il tuo SSID e PSK per la rete, e clicca sull'icona Salva.
