Resumen de MQTT¶
El applet MQTT conecta AetherSDR con un broker MQTT de la estación para que pueda suscribirse a temas, ver mensajes entrantes y salientes en un registro en vivo, superponer valores de temas en el panadapter y publicar mensajes predefinidos con botones configurables. No se requiere conexión de radio.
Antes de comenzar¶
- Debe tener acceso a un broker MQTT en su red (por ejemplo, Mosquitto ejecutándose en
localhost). - Si el applet MQTT no está visible, actívelo haciendo clic en el botón de bandeja MQTT en la barra lateral derecha. El applet está oculto por defecto.
- Si el botón de bandeja MQTT no aparece, es posible que su compilación de AetherSDR no incluya soporte MQTT (se requiere la compuerta de compilación
HAVE_MQTT).
Cómo funciona¶
Al hacer clic en Enable (cambiándolo de Off a On), el applet carga la contraseña MQTT del llavero del sistema, guarda toda la configuración del broker y abre una conexión con el broker. Se suscribe a todos los temas configurados en el diálogo MQTT Settings. Los mensajes entrantes aparecen en el registro de mensajes como líneas topic: value; los mensajes salientes publicados aparecen como líneas TX topic: value. El registro conserva las últimas 50 líneas. Los temas prefijados con * en la lista de suscripción envían además su último valor al panadapter como superposición. Los botones de publicación le permiten enviar una carga útil fija a un tema fijo con un solo clic mientras está conectado.
Al hacer clic nuevamente en Enable (cambiándolo de On a Off), se desconecta inmediatamente y se eliminan todas las superposiciones del panadapter.
La configuración se guarda en disco solo cuando Enable pasa de Off a On.
Función de cada control¶
| Control | Predeterminado | Rango válido |
|---|---|---|
| Enable | Off | Off / On |
| Settings... | Abre el diálogo MQTT Settings (MqttSettingsDialog) para configurar la conexión al broker, las suscripciones y los botones de publicación. | Nuevo en v26.5.3. Reemplaza los campos inline de Host/Port/User/Pass/TLS/Topics. |
| Publish buttons | Al hacer clic, publica la carga útil configurada en el tema configurado mediante MqttClient::publish. Los botones se configuran en el diálogo MQTT Settings. | Solo activos mientras está conectado. Se configuran en la pestaña Publish Buttons de MqttSettingsDialog. |
| Message log | Muestra los mensajes recibidos como líneas 'topic: value'. También procesa actualizaciones de alias de antena desde MQTT. | Limitado a 50 entradas. |
Indicador de estado¶
La etiqueta de estado junto a Enable muestra el estado actual de la conexión:
- Connected — se muestra en verde cuando la conexión con el broker está establecida.
- Disconnected — se muestra en gris cuando no está conectado.
- \<mensaje de error> — se muestra en el color predeterminado cuando ocurre un error de conexión; el texto describe el error.
Consejos¶
- Los temas se comparan exactamente. Si un tema tiene una ruta profunda como
rotator/az/pos, el registro de mensajes muestra solo el último segmento de la ruta (pos) como etiqueta, pero la ruta completa se utiliza para la superposición en el panadapter. - No necesita una conexión de radio para usar MQTT. El applet funciona independientemente del estado de la conexión FlexRadio.
- Los botones de publicación están inactivos (los clics no tienen efecto) mientras esté desconectado. Conéctese primero, luego use los botones.
- La contraseña MQTT se almacena en el llavero del sistema. Al habilitar por primera vez, el applet muestra "Waiting for keychain" hasta que se cargue la contraseña.
- Todos los ajustes de conexión al broker (host, puerto, credenciales, TLS, suscripciones) se configuran exclusivamente a través del diálogo MQTT Settings (Settings > MQTT...).
- El applet MQTT ahora usa colores que se adaptan al tema para todos los controles y etiquetas, ajustándose correctamente a temas claros y oscuros.
- El registro de mensajes ahora muestra tanto mensajes entrantes como salientes. Los mensajes salientes aparecen con un prefijo
TX(por ejemplo,TX rotator/az/set: 180) para distinguirlos de los mensajes entrantes.