Conectarse a un broker MQTT de la estación¶

Esta página explica cómo abrir el applet MQTT y conectar AetherSDR a un broker MQTT de la estación para suscribirse a temas, ver mensajes entrantes, publicar cargas predefinidas y monitorear confirmaciones de publicación.

Antes de comenzar¶

Su broker MQTT debe estar funcionando y ser accesible desde la máquina que ejecuta AetherSDR.
Conozca el nombre de host o la dirección IP del broker, el puerto y las credenciales (si las hubiera).
AetherSDR fue compilado con soporte MQTT (HAVE_MQTT). Si el botón MQTT en la bandeja está ausente, su compilación no incluye esta funcionalidad.

Pasos¶

Si el panel de applets no está visible, haga clic en View > Applet Panel para mostrarlo.
Haga clic en el botón MQTT de la bandeja en la barra lateral derecha. Se abre el applet MQTT.
Haga clic en Settings... en el encabezado del applet MQTT. Se abre el diálogo de Configuración MQTT.
En la pestaña Connection, ingrese el nombre de host o la dirección IP del broker en el campo Host. El valor predeterminado es localhost.
En el campo Port, ingrese el puerto TCP del broker. El valor predeterminado es 1883. Rango válido: 1–65535.
Si el broker requiere autenticación, ingrese sus credenciales en los campos User y Pass. Ambos son opcionales y pueden dejarse en blanco. La contraseña se almacena en el llavero de claves del sistema.
En el campo Topics, ingrese una lista separada por comas de temas a los que suscribirse. Déjelo en blanco si solo necesita publicar. Para superponer el valor de un tema en el panadapter, antepóngale *. Ejemplo:
```
*rotator/pos, *ant/selected, station/log
```
Si el broker requiere TLS, marque la casilla TLS. El campo de puerto cambia automáticamente de 1883 a 8883. Si necesita un certificado CA personalizado, ingrese la ruta del archivo en el campo CA cert que aparece. Deje CA cert en blanco para usar el paquete CA del sistema.
Configure los botones de publicación en la pestaña Publish Buttons si lo desea.
Haga clic en OK para guardar la configuración y cerrar el diálogo.
Haga clic en Enable (que actualmente muestra "Off") para conectarse. La etiqueta del botón cambia a "On" y se guarda la configuración.
Observe la etiqueta de estado a la derecha del botón. Muestra "Connected" en verde cuando el broker acepta la conexión.

Qué hace cada control¶

Control	Descripción	Valor predeterminado
Settings...	Abre el diálogo de Configuración MQTT (MqttSettingsDialog) para la conexión al broker, suscripciones y configuración de botones de publicación.	Nuevo en v26.5.3. Reemplaza los campos Host/Port/User/Pass/TLS/Topics en línea.
Publish buttons	Hasta 12 botones configurables; al hacer clic, publica la carga configurada en el tema configurado.	Configurado mediante la pestaña Publish Buttons en MqttSettingsDialog.
Message log	Muestra los mensajes recibidos como líneas `topic: value` y los mensajes publicados como líneas `TX topic: payload`. También procesa actualizaciones de alias de antena desde MQTT.	Limitado a 50 entradas.
Enable	Conecta (On) o desconecta (Off); guarda toda la configuración al conectar. La contraseña se carga del llavero de claves del sistema al activar por primera vez.	Off
Status label	Muestra el estado de la conexión con color: verde cuando está conectado, gris cuando está desconectado, valor predeterminado en caso de error.	Disconnected

Consejos¶

La configuración se guarda en almacenamiento persistente solo cuando hace clic en OK en el diálogo de Configuración MQTT, no cuando hace clic en Enable para conectarse.
El campo CA cert y su etiqueta están ocultos cuando TLS no está marcado. Marque primero TLS para que aparezca la fila.
Message log mantiene los últimos 50 bloques de mensajes. Las entradas más antiguas se eliminan automáticamente. Tanto los mensajes recibidos como los publicados aparecen en el registro. Los mensajes publicados tienen el prefijo TX (ej., TX topic: payload).
Los botones de publicación solo están activos mientras está conectado. Consulte Añadir o eliminar botones de publicación personalizados para configurarlos.
Si la contraseña del llavero de claves del sistema aún no se ha cargado, la etiqueta de estado muestra "Waiting for keychain" hasta que se recupere la contraseña.

Solución de problemas¶

La etiqueta de estado muestra un mensaje de error en lugar de "Connected" — El broker rechazó la conexión o es inaccesible. Verifique el Host, Port y las credenciales. Si TLS está habilitado, confirme que el broker esté escuchando en el puerto 8883 y que la ruta del certificado CA sea correcta.
La etiqueta de estado muestra "Waiting for keychain" — La contraseña aún no se ha cargado del llavero de claves del sistema. Haga clic en Enable nuevamente o reinicie el applet.
El botón MQTT de la bandeja está ausente — AetherSDR fue compilado sin soporte MQTT. Necesita una compilación realizada con el indicador HAVE_MQTT.
El puerto no cambió al marcar TLS — El cambio automático solo se activa si el valor actual del puerto es exactamente 1883 (cambiando a 8883) o 8883 (cambiando a 1883). Si había ingresado un puerto personalizado, este no se modifica.
El campo Topics acepta entrada pero no aparecen mensajes — Confirme que el broker está publicando en las cadenas de tema exactas ingresadas. La coincidencia de temas MQTT distingue entre mayúsculas y minúsculas.