Si tu dispositivo está conectado a Internet vía Wi-Fi o Ethernet, puedes habilitarlo para reenviar paquetes a un servidor MQTT. Esto permite que los usuarios en la malla local se comuniquen con usuarios en Internet. Uno o más canales también deben estar habilitados como enlace ascendente y/o descendente para que los paquetes se transmitan desde y/o hacia tu malla (ver canales).
Las opciones de configuración del módulo MQTT incluyen: Habilitado, Dirección del servidor, Nombre de usuario, Contraseña, Cifrado habilitado, JSON habilitado, TLS habilitado, Tema raíz, Proxy de cliente habilitado, Informe de mapa habilitado (con Precisión de posición e Intervalo de publicación), y Permitir a MQTT. La configuración del módulo MQTT usa un mensaje de administrador que envía un protobuf ConfigModule.MQTT.
Valores de configuración del módulo MQTT
-
Habilitado: Activa el módulo MQTT.
-
Dirección del servidor: El servidor que se usará para MQTT. Si no se establece, se utilizará el servidor público predeterminado.
-
Nombre de usuario: El nombre de usuario del servidor MQTT a usar (más útil para un servidor MQTT personalizado). Si se usa un servidor personalizado, se respetará incluso si está vacío. Si se usa el servidor público predeterminado, solo se respetará si está configurado; de lo contrario, el dispositivo usará el nombre de usuario predeterminado.
-
Contraseña: La contraseña MQTT a usar (más útil para un servidor MQTT personalizado). Si se usa un servidor personalizado, se respetará incluso si está vacía. Si se usa el servidor predeterminado, solo se respetará si está configurada; de lo contrario, el dispositivo usará la contraseña predeterminada.
-
Cifrado habilitado: Se puede configurar si se envían paquetes cifrados o no cifrados al servidor MQTT. Los paquetes no cifrados pueden ser útiles para sistemas externos que deseen consumir paquetes Meshtastic. Nota: Todos los mensajes se envían al broker MQTT sin cifrar si esta opción no está habilitada, incluso cuando tus canales de enlace ascendente tienen claves de cifrado configuradas.
-
JSON Habilitado: JSON no es compatible con la plataforma nRF52. Puede habilitar el envío y consumo de paquetes JSON en MQTT. Estos paquetes no están cifrados pero proporcionan una forma sencilla de integrarse con sistemas que pueden leer JSON.
-
TLS Habilitado: Si se establece en true, intentaremos establecer una conexión segura usando TLS.
-
Tema Raíz: El tema raíz a usar para los mensajes MQTT es importante. Esto es útil si desea utilizar un solo servidor MQTT para múltiples redes Meshtastic y separarlas mediante ACLs.
-
Proxy de Cliente Habilitado: Si se establece en true, el dispositivo usará la conexión de red del cliente (por ejemplo, la de su teléfono) para conectarse al servidor MQTT. Si se establece en false, usará la conexión de red propia del dispositivo, que debe estar habilitada a través de la configuración de red.
Informe de Mapa Habilitado
Disponible a partir de la versión de firmware 2.3.2 en adelante, si se establece en true, su nodo enviará periódicamente un informe de mapa sin cifrar al servidor MQTT para su visualización en mapas en línea que soporten este paquete. Este informe incluye la siguiente información:
-
El nombre largo y corto del nodo y su ID
-
La posición del nodo (con precisión configurable) y la altitud
-
El modelo de hardware del nodo y su rol
-
La versión del firmware del nodo
-
La región LoRa del nodo, configuración del módem y nombre del canal principal
-
Si el nodo puede ser alcanzado en el canal predeterminado con una clave conocida
-
Número de nodos locales en línea (escuchados en las últimas 2 horas, excluyendo aquellos escuchados vía MQTT)
Precisión de la Posición del Informe del Mapa se refiere a la precisión utilizada para la posición en el informe del mapa, con una desviación máxima predeterminada de alrededor de 1459m.
Intervalo de Publicación del Informe del Mapa especifica con qué frecuencia se debe publicar el informe del mapa en el servidor MQTT en segundos, con una configuración predeterminada de 900 segundos (15 minutos).
Configuración del Módulo MQTT Cliente
Android
MQTT Configuración opciones están disponibles para Android.
-
abrir la Aplicación Meshtastic
-
Navega a: Elipsis Vertical (3 puntos en la esquina superior derecha) > Configuración de Radio > MQTT.
Manzana
Todas las opciones de configuración MQTT están disponibles en iOS, iPadOS y macOS. Para acceder a ellas, ve a: Ajustes > Configuración del Módulo > MQTT.
CLI
Las siguientes opciones de configuración están disponibles en el CLI de Python:
| Configuración | Valores Aceptables | Predeterminado |
| mqtt.enabled | true, false | FALSO |
| mqtt.address | string | mqtt.meshtastic.org |
| mqtt.username | string | meshdev |
| mqtt.password | string | large4cats |
| mqtt.encryption_enabled | true, false | FALSO |
| mqtt.json_enabled | true, false | FALSO |
| mqtt.tls_enabled | true, false | FALSO |
| mqtt.root | string | |
| mqtt.proxy_to_client_enabled | true, false | FALSO |
| mqtt.map_reporting_enabled | true, false | FALSO |
-
Habilitar/Deshabilitar Módulo MQTT
meshtastic --set mqtt.enabled true meshtastic --set mqtt.enabled false
-
Habilitar/Deshabilitar MQTT JSON
meshtastic --set mqtt.json_enabled true meshtastic --set mqtt.json_enabled false
NOTA: Dado que el dispositivo se reiniciará después de enviar cada comando vía CLI, se recomienda encadenar los comandos en uno solo al configurar múltiples valores en una sección de configuración. Por ejemplo:
meshtastic --set mqtt.enabled true --set mqtt.json_enabled true
Web
Todas las opciones de configuración del módulo MQTT están disponibles para la Interfaz Web.
Accede al Servidor Público Predeterminado
Android
-
Habilitar el módulo MQTT
Navega a: Elipsis Vertical (3 puntos en la esquina superior derecha) > Configuración de Radio > MQTT: Activa el deslizador para MQTT habilitado y toca Enviar.
Opcional: Para usar la conexión a internet de tu teléfono para enviar y recibir paquetes a través de la web, también activa el deslizador para MQTT Cliente Proxy y omite el paso de Configurar Ajustes de Red a continuación.
-
Habilitar enlace ascendente y descendente del canal
Navega a: Elipsis Vertical (3 puntos en la esquina superior derecha) > Configuración de Radio > Canales > LongFast: Activa los deslizadores para Uplink habilitado y Downlink habilitado, luego toca Guardar y toca Enviar.
-
Configurar ajustes de red
Navega a: Elipsis Vertical (3 puntos en la esquina superior derecha) > Configuración de Radio > Red: Activa el deslizador para WiFi habilitado, ingresa el SSID y PSK de tu red, luego toca Enviar.
Manzana
-
Activar el módulo MQTT Ve a Settings > MQTT: Activa el interruptor MQTT enabled en la posición ON y luego toca Guardar.
Opcional: Si deseas usar la conexión a internet de tu teléfono para enviar y recibir paquetes en línea, activa también el interruptor MQTT Client Proxy y omite el paso Configurar ajustes de red a continuación.
-
Activar enlace ascendente y descendente del canal Ve a Settings > Channels > Primary Channel: Activa los interruptores Uplink enabled y Downlink enabled en la posición ON, luego toca Guardar.
-
Configurar ajustes de red Ve a Settings > Network: Activa el interruptor WiFi enabled en ON, luego ingresa tu SSID y PSK para la red, y toca Guardar.
CLI
-
Habilitar el módulo MQTT
meshtastic --set mqtt.enabled true
-
Habilitar enlace ascendente y descendente del canal
meshtastic --ch-set uplink_enabled true --ch-index 0 meshtastic --ch-set downlink_enabled true --ch-index 0
o encadenados:
meshtastic --ch-set uplink_enabled true --ch-index 0 --ch-set downlink_enabled true --ch-index 0
-
Configurar ajustes de red
meshtastic --set network.wifi_enabled true meshtastic --set network.wifi_ssid "tu red" meshtastic --set network.wifi_psk tucontraseña
o encadenados:
meshtastic --set network.wifi_enabled true --set network.wifi_ssid "tu red" --set network.wifi_psk tucontraseña
Web
-
Activar el módulo MQTT Ve a Config > Module Config > MQTT - Activa el interruptor MQTT enabled en ON - Haz clic en el icono Guardar.
Opcional: Si deseas usar la conexión a internet de tu cliente para enviar y recibir paquetes en línea, activa también el control deslizante Proxy to Client Enabled y omite el paso Configurar ajustes de red a continuación.
NOTA: Aunque esta opción pueda ser visible en tu interfaz, el Client Proxy no está operativo actualmente con el Web Client.
-
Activar enlace ascendente y descendente del canal Ve a Channels > Primary: Activa los interruptores Uplink Enabled y Downlink Enabled en la posición ON - Haz clic en el icono Guardar.
-
Configurar ajustes de red Ve a Radio Config > Device > Network: Activa el interruptor Enabled en la posición ON, ingresa tu SSID y PSK para la red, y haz clic en el icono Guardar.
