Applet MQTT¶

El applet MQTT integra AetherSDR con un broker MQTT de la estación. Permite publicar mensajes predefinidos con botones editables por el usuario, monitorear mensajes entrantes, ver los mensajes publicados en el registro de mensajes y superponer valores de temas en el panadapter.

Descripción general¶

El applet MQTT proporciona cuatro funciones principales: - Botones de publicación: Hasta 12 botones definidos por el usuario que envían cargas útiles fijas a temas fijos al hacer clic. - Registro de mensajes: Muestra hasta 50 mensajes recibidos y mensajes publicados como líneas "tema: valor". - Registro de mensajes publicados: Muestra los mensajes enviados con el prefijo "TX" en el registro de mensajes. - Control de conexión: Alternancia Activar/Desactivar para conectar o desconectar del broker.

Configuración de la conexión¶

Los ajustes de conexión (host, puerto, credenciales, TLS y suscripciones) se configuran en el diálogo dedicado de Configuración MQTT.

En el applet MQTT, haga clic en Settings....
En el diálogo de Configuración MQTT, configure la conexión al broker:
Host: Nombre de host o dirección IP del broker.
Port: Puerto del broker (1883 por defecto para conexión simple, 8883 para TLS).
User: Nombre de usuario para autenticación (déjelo en blanco si no es necesario).
Password: Contraseña para autenticación. Se almacena en el llavero del sistema.
TLS: Habilita el cifrado TLS.
CA cert: Ruta al archivo de certificado CA (opcional; en blanco usa el paquete de CA del sistema).
Configure los temas de suscripción en la pestaña Subscriptions:
Ingrese temas separados por comas para suscribirse.
Prefije con * para mostrar en la superposición del panadapter.
Ejemplo: *rotator/pos, *ant/selected, station/log
Configure los botones de publicación en la pestaña Publish Buttons.
Haga clic en OK para guardar la configuración.

Conectarse al broker¶

En el applet MQTT, haga clic en Enable (botón de alternancia) para conectarse.
La etiqueta de estado muestra el estado de la conexión:
Disconnected (gris) - no conectado.
Connected (verde) - conectado y listo.
Mensaje de error (color por defecto) - falló la conexión.

Al habilitar por primera vez, la contraseña se carga desde el llavero del sistema. Si la contraseña del llavero aún no se ha cargado, el estado muestra "Waiting for keychain".

Para desconectarse, haga clic en Enable nuevamente.

Botones de publicación¶

El applet MQTT admite hasta 12 botones de publicación definidos por el usuario. Cada botón envía una carga útil fija a un tema fijo al hacer clic.

Antes de comenzar¶

El applet MQTT debe estar visible. Si no lo está, haga clic en el botón MQTT de la bandeja en la barra lateral derecha para mostrarlo.
No es necesario estar conectado al broker para editar los botones. Sin embargo, los botones solo publican cuando el applet está conectado (el estado muestra "Connected").
Las definiciones de botones se almacenan en MqttButtons y persisten entre sesiones.

Agregar un botón¶

En el applet MQTT, haga clic en Settings....
En el diálogo de Configuración MQTT, vaya a la pestaña Publish Buttons.
Haga clic en Add.
En el diálogo que se abre, ingrese una etiqueta, un tema y una carga útil para el nuevo botón.
Haga clic en OK para confirmar.
Haga clic en OK en el diálogo de Configuración MQTT para guardar.

Editar un botón existente¶

Haga clic en Settings....
En el diálogo de Configuración MQTT, vaya a la pestaña Publish Buttons.
Haga clic en el botón que desea cambiar. Se abre un diálogo de edición que muestra la etiqueta, el tema y la carga útil actuales.
Cambie los valores según sea necesario y haga clic en OK.
Haga clic en OK en el diálogo de Configuración MQTT para guardar.

Eliminar un botón¶

Haga clic en Settings....
En el diálogo de Configuración MQTT, vaya a la pestaña Publish Buttons.
Haga clic con el botón derecho en el botón que desea eliminar.
Haga clic en Remove en el menú contextual que aparece.
Haga clic en OK en el diálogo de Configuración MQTT para guardar.

Qué hace cada control¶

Control	Predeterminado	Notas
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 integrados de Host/Port/User/Pass/TLS/Topics.
Botones de publicación	—	Al hacer clic se publica la carga útil configurada en el tema configurado mediante MqttClient::publish. Los botones se configuran en el diálogo de Configuración MQTT. Solo activos mientras está conectado. Configurados mediante la pestaña Publish Buttons de MqttSettingsDialog. Hasta 12 botones.
Registro de mensajes	—	Muestra los mensajes recibidos como líneas "tema: valor". También procesa actualizaciones de alias de antena desde MQTT. Limitado a 50 entradas.
Enable (Off/On)	Off	Conecta o desconecta del broker usando la configuración de MqttSettings. Emite connectRequested / disconnectRequested y guarda el estado habilitado de la conexión. La contraseña se carga desde el llavero del sistema al habilitar por primera vez. Si la contraseña del llavero aún no se ha cargado, muestra el estado 'Waiting for keychain'.

Comportamiento del registro de mensajes¶

El registro de mensajes muestra tanto los mensajes recibidos como los publicados: - Mensajes recibidos: Se muestran como tema: valor donde el tema es el último segmento de la ruta completa del tema. - Mensajes publicados: Se muestran como TX tema: valor donde el tema es el último segmento de la ruta del tema de publicación y el valor son los primeros 80 caracteres de la carga útil.

El registro está limitado a 50 entradas. Cuando se alcanza el límite, se elimina la entrada más antigua para hacer espacio para las nuevas.

Indicadores de estado¶

Indicador	Estados	Significado
Etiqueta de estado	Disconnected, Connected, \<mensaje de error>	Estado de la conexión con color: verde cuando está conectado, gris cuando está desconectado, color por defecto en caso de error.

Consejos¶

Las sugerencias de los botones muestran el tema de destino y la carga útil cuando el applet está en modo normal (topic → payload).
Los botones están inactivos cuando el applet está desconectado. Conéctese primero y luego use los botones para publicar.
Si necesita publicar en el mismo tema con diferentes cargas útiles, cree un botón por carga útil.
La contraseña se almacena en el llavero del sistema por seguridad.
El registro de mensajes muestra los mensajes publicados con el prefijo "TX", lo que le ayuda a confirmar que sus botones de publicación envían correctamente.

Solución de problemas¶

Al hacer clic en un botón de publicación no ocurre nada — El applet no está conectado. Verifique que la etiqueta de estado diga "Connected". Si dice "Disconnected" o muestra un mensaje de error, haga clic en Enable para conectarse.
No se pueden agregar más de 12 botones — 12 es el número máximo de botones de publicación. Elimine al menos un botón antes de agregar otro.
La conexión falla — Verifique que el host, el puerto y las credenciales del broker en Settings... sean correctos. Asegúrese de que el broker esté en ejecución y sea accesible.
El mensaje de contraseña aparece en cada conexión — Es posible que el llavero del sistema no sea accesible. Verifique la configuración del llavero del sistema.