GUÍA · MQTT

Conectar un nodo al MQTT de TuiterRocks

Esta guía explica dónde está cada ajuste y qué tienes que activar para conectar Meshtastic a la infraestructura MQTT de TuiterRocks.

Importante: el MQTT no cambia el preset ni los canales de radio de tu zona. Mantén la configuración LoRa coordinada con la comunidad local.

Antes de empezar

Meshtastic instalado

Conecta el nodo a la aplicación y comprueba que funciona normalmente por Bluetooth, USB o Wi-Fi.

Acceso a Internet

El nodo necesitará Internet directamente por Wi-Fi/Ethernet o a través del teléfono mediante Proxy MQTT.

Configuración de radio

Utiliza el preset y los canales que correspondan a la zona donde estás usando el nodo.

Posición, solo si quieres

Si quieres aparecer en el mapa público, el nodo debe tener una posición válida y debes activar la publicación de posición para el mapa MQTT.

Valores del MQTT de TuiterRocks

Servidor
mqtt.tuiter.rocks
Puerto
1883
Root topic
tuiterrocks/mesh
Usuario
meshrockslab
Contraseña
rocks4ever

Estas son las credenciales comunitarias publicadas por TuiterRocks para el acceso al servicio MQTT.

1. Abre la configuración MQTT

En la aplicación de Meshtastic abre la configuración del nodo y entra en:

Configuración → Configuración de módulo → MQTT

Los nombres pueden variar ligeramente entre Android, iOS, web y distintas versiones de Meshtastic, pero los ajustes son los mismos.

2. Si tu nodo tiene Wi-Fi

Este es el método más directo. Es habitual en placas ESP32 como Heltec V3 o V4 y en dispositivos fijos con conectividad IP.

  1. Configura primero la conexión Wi-Fi del nodo y comprueba que tiene acceso a Internet.
  2. Entra en Configuración de módulo → MQTT.
  3. Activa el módulo MQTT.
  4. Introduce servidor, puerto, usuario, contraseña y root topic con los valores indicados arriba.
  5. Activa Permitir encriptación.
  6. Guarda la configuración y deja que el nodo aplique o reinicie los cambios si la aplicación lo solicita.
Wi-Fi y Bluetooth: en algunos dispositivos Meshtastic basados en ESP32, al activar Wi-Fi puede cambiar la forma en la que te conectas al nodo. No confundas la conectividad de la aplicación con la conexión MQTT a Internet.

3. Si tu nodo no tiene Wi-Fi

Dispositivos como SenseCAP T1000-E, Wio Tracker L1 Pro, T-Echo y muchas plataformas nRF52 no tienen Wi-Fi integrado. En ese caso el teléfono puede proporcionar la conexión a Internet.

  1. Conecta el nodo al teléfono por Bluetooth.
  2. En Configuración de módulo → MQTT, activa el módulo MQTT.
  3. Introduce los datos del servidor de TuiterRocks.
  4. Activa Proxy MQTT en la configuración MQTT del nodo.
  5. En la aplicación, activa Compartir Internet a la malla.
  6. Mantén el teléfono conectado por Bluetooth y con acceso a Internet.
Si el móvil deja de actuar como proxy, el nodo seguirá funcionando normalmente por LoRa, pero dejará de intercambiar tráfico con el MQTT hasta recuperar esa conexión.

4. Decide qué canales utilizan MQTT

MQTT y los canales Meshtastic son cosas distintas. Para que un canal transporte tráfico a través del broker debes decidir expresamente si quieres habilitar subida y/o bajada.

Uplink

Permite que los mensajes recibidos o generados en ese canal puedan enviarse hacia MQTT.

Downlink

Permite que tráfico procedente de MQTT pueda volver a entrar en ese canal y propagarse por radio cuando corresponda.

No actives todo por rutina

Habilita uplink y downlink solamente en los canales que realmente quieras comunicar a través de Internet.

Ignorar MQTT

En un nodo que deba aceptar tráfico MQTT hacia la radio, Ignorar MQTT debe permanecer desactivado.

5. Si quieres aparecer en el mapa

La publicación de posición para el mapa MQTT es independiente de compartir posición periódicamente en un canal de radio.

  1. Asegúrate de que el nodo tiene una posición válida.
  2. Puede proceder del GPS del dispositivo o de una posición fija configurada manualmente.
  3. En la configuración MQTT activa Posición en el mapa.
  4. Guarda la configuración y deja al nodo conectado a Internet.
La posición puede hacerse pública. Si activas la publicación de posición para el mapa MQTT, esa ubicación puede mostrarse en el mapa público de TuiterRocks. No la actives si no quieres publicar la ubicación del nodo.

6. Comprueba que funciona

Live

Es la forma más rápida de comprobar actividad reciente y ver si el nodo está llegando a la infraestructura.

Abrir Live

Mapa

Si has activado la publicación de posición, el nodo puede aparecer en el mapa general. La actualización general no es inmediata.

Abrir mapa

History

Permite revisar posteriormente la actividad observada y comprobar si hubo comunicaciones en otros momentos.

Abrir History

Ten paciencia

El mapa general se actualiza aproximadamente cada 30 minutos. Para comprobaciones rápidas utiliza Live.

Si no funciona

No aparece ninguna actividad

Comprueba primero que el nodo tenga Internet. Si utiliza proxy, revisa Bluetooth, Proxy MQTT y Compartir Internet a la malla.

Está conectado pero no veo mensajes

Revisa qué canales tienen habilitado uplink/downlink y comprueba que Ignorar MQTT no esté bloqueando el tráfico que quieres recibir.

Hay actividad pero no aparece en el mapa

Comprueba que el nodo tenga coordenadas válidas y que hayas activado Posición en el mapa.

El proxy funciona solo a veces

Comprueba que Android o iOS no estén cerrando la aplicación en segundo plano y que el teléfono mantenga Bluetooth e Internet.

Configuración general de Meshtastic

Esta guía explica únicamente la conexión con TuiterRocks. Para firmware, preset, canales, roles y configuración general, consulta las guías correspondientes a tu zona.