Configurar 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 dirección IP de su broker, el puerto, y cualquier nombre de usuario y contraseña requeridos.
Pasos¶
- Abra
Settings > MQTT...para mostrar el cuadro de diálogo MQTT Settings. - 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 simple o 8883 para TLS).
- Username — opcional; déjelo en blanco si su broker no requiere autenticación.
- Password — opcional; se almacena en el llavero de su 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 los ajustes y cerrar el cuadro de diálogo.
- En el applet MQTT, haga clic en Off para cambiarlo a On. AetherSDR se conecta usando los nuevos ajustes. La etiqueta de estado cambia a Connected (verde) si tiene éxito, o muestra un mensaje de error si la conexión falla.
Qué hace cada control¶
| Control | Valor predeterminado | Notas |
|---|---|---|
| Username | (vacío) | Nombre de usuario de autenticación |
| Password | (vacío) | Se almacena 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 cuadro de diálogo MQTT Settings (MqttSettingsDialog) para configurar la conexión al broker, suscripciones y botones de publicación. Nuevo en v26.5.3. Reemplaza los campos integrados Host/Port/User/Pass/TLS/Topics. | |
| Enable (Off/On) | Off | Conecta o desconecta del broker usando los ajustes de MqttSettings. Emite connectRequested/disconnectRequested y guarda el estado de conexión habilitado. La contraseña se carga desde el llavero del sistema al habilitar por primera vez. Si la contraseña del llavero aún no está cargada, muestra el estado 'Waiting for keychain'. |
| Publish buttons | Al hacer clic, publica la carga útil configurada en el tema configurado mediante MqttClient::publish. Los botones se configuran en el cuadro de diálogo MQTT Settings. Solo están activos mientras está conectado. Se configuran mediante la pestaña Publish Buttons de MqttSettingsDialog. | |
| Message log | Muestra los mensajes recibidos como líneas 'topic: value' y los mensajes transmitidos como líneas 'TX topic: payload'. También procesa actualizaciones de alias de antena desde MQTT. Limitado a 50 entradas. | |
| Status label | Disconnected | Muestra "Connected" (verde) si tiene éxito, "Disconnected" (gris) cuando está apagado o falla, o un mensaje de error (color predeterminado). |
Consejos¶
- La contraseña se migra al llavero de su sistema la primera vez que habilita la conexión MQTT. Si la migración falla, AetherSDR registra una advertencia y conserva la entrada en 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, adaptándose automáticamente tanto a temas claros como oscuros.
- v26.6.3: El registro de mensajes ahora también muestra los mensajes transmitidos como líneas
TX topic: payload, 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, confirme 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 los ajustes TLS coincidan 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 cuadro de diálogo MQTT Settings. El registro solo muestra transmisiones de AetherSDR, no de otros clientes MQTT.