Configurar los ajustes de conexión del broker (host, puerto, credenciales, TLS)¶
Configure la dirección del broker MQTT, la autenticación y las opciones TLS que AetherSDR utiliza para conectarse al broker MQTT de su estación.
Antes de comenzar¶
- El applet MQTT debe estar visible en la barra lateral derecha. Si está oculto, haga clic en el botón de la bandeja MQTT para mostrarlo.
- Necesita el nombre de host o la dirección IP de su broker, el puerto y el nombre de usuario y contraseña requeridos.
Pasos¶
- Abra
Settings > MQTT...para mostrar el diálogo de configuración MQTT. - En la pestaña Broker Connection, ingrese lo siguiente:
- Host — el nombre de host o dirección IP de su broker.
- Port — el puerto TCP (el valor predeterminado depende de su broker; los valores comunes son 1883 para TCP sin cifrar o 8883 para TLS).
- Username — opcional; déjelo en blanco si su broker no requiere autenticación.
- Password — opcional; se almacena en su llavero de sistema cuando habilita la conexión por primera vez (no en texto plano).
- Para habilitar TLS:
- Marque Use TLS.
- Si su broker utiliza un certificado CA personalizado, ingrese la ruta del archivo en CA Certificate File (o haga clic en Browse... para localizarlo).
- Haga clic en OK para guardar la configuración y cerrar el diálogo.
- En el applet MQTT, haga clic en Off para cambiarlo a On. AetherSDR se conecta usando la nueva configuración. La etiqueta de estado cambia a Connected (verde) en caso de éxito, o muestra un mensaje de error si la conexión falla.
Función de cada control¶
| Control | Valor predeterminado | Notas |
|---|---|---|
| Username | (vacío) | Nombre de usuario de autenticación |
| Password | (vacío) | Almacenado en el llavero del sistema cuando se usa por primera vez |
| Use TLS | sin marcar | Activa o desactiva el cifrado TLS |
| CA Certificate File | (vacío) | Ruta al certificado CA personalizado para TLS |
| Settings... | Abre el diálogo de configuración MQTT (MqttSettingsDialog) para la conexión del broker, suscripciones y configuración de botones de publicación. Nuevo en v26.5.3. Reemplaza los campos inline de Host/Puerto/Usuario/Contraseña/TLS/Temas. | |
| Enable (Off/On) | Conecta o desconecta del broker usando la configuración de MqttSettings. Emite connectRequested / disconnectRequested y guarda el estado de conexión habilitada. | 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'. |
| Botones de publicación | Haga clic para publicar la carga útil configurada en el tema configurado a través de MqttClient::publish. Los botones se configuran en el diálogo de configuración MQTT. | Solo activos mientras está conectado. Se configuran a través de la pestaña Publish Buttons de MqttSettingsDialog. |
| Registro de mensajes | Muestra los mensajes recibidos como líneas 'tema: valor'. También procesa las actualizaciones de alias de antena desde MQTT. | Limitado a 50 entradas. |
| Etiqueta de estado | Disconnected | Muestra "Connected" (verde) en caso de éxito, "Disconnected" (gris) cuando está apagado o falla, o un mensaje de error (color predeterminado). |
| ## Consejos |
- La contraseña se migra a su llavero de sistema la primera vez que habilita la conexión MQTT. Si la migración falla, AetherSDR registra una advertencia y conserva la entrada de texto plano para reintentarlo.
- Si habilita la conexión ("On") pero la contraseña aún no se ha cargado desde el llavero, el estado muestra Waiting for keychain hasta que se complete la lectura del llavero.
- v26.6.1: El applet MQTT ahora utiliza colores adaptados al tema para todos los elementos de la interfaz de usuario, adaptándose automáticamente a temas claros y oscuros.
- v26.6.3: El registro de mensajes ahora también muestra los mensajes transmitidos como líneas
TX tema: carga útil, ayudándole a confirmar que los botones de publicación envían los datos correctos. - Los temas de alias de antena se suscriben automáticamente.
Solución de problemas¶
- El estado muestra "Disconnected" después de cambiar a On — Verifique que el host y el puerto sean correctos y accesibles desde su máquina. Si usa TLS, verifique que la ruta del certificado CA sea válida.
- El estado muestra un mensaje de error — El broker rechazó la conexión. Confirme el nombre de usuario y la contraseña, y que la configuración TLS coincida con la configuración de su broker.
- "Waiting for keychain" nunca se resuelve — El llavero del sistema puede estar bloqueado o no disponible. Desbloquee su llavero y cambie la conexión a Off y luego a On nuevamente.
- Los mensajes publicados no aparecen en el registro — Verifique que el tema y la carga útil del botón de publicación estén configurados correctamente en el diálogo de configuración MQTT. El registro solo muestra las transmisiones de AetherSDR, no de otros clientes MQTT.