Active el TCP de CAT para que N1MM, Log4OM, WSJT-X puedan controlar la radio¶
El applet de Control CAT ejecuta hasta cuatro servidores TCP compatibles con rigctld (y enlaces simbólicos PTY en Linux/macOS), uno por canal de slice (A–D), para que el software externo de registro y concursos pueda controlar la radio a través de un socket de red o una ruta de tipo serie. El applet utiliza una implementación nativa del controlador Hamlib NET rigctl, eliminando la necesidad de un puente rigctld independiente. Use esta página para iniciar esos servidores y apuntar su software de registro al puerto correcto.
Antes de comenzar¶
- AetherSDR debe estar conectado a la radio. El applet CAT requiere una conexión activa a la radio.
- Decida qué puerto base utilizar. El valor predeterminado es
4532. Los canales A, B, C y D se vinculan al puerto base, base+1, base+2 y base+3 respectivamente. - Asegúrese de que ninguna otra aplicación (incluida una instancia independiente de rigctld) esté escuchando ya en esos puertos.
Pasos¶
- Haga clic en el botón de la bandeja CAT en la barra lateral derecha para abrir el applet de Control CAT. El applet está oculto de forma predeterminada.
- Verifique el valor en el campo Base. El valor predeterminado es
4532. Cámbielo si es necesario (rango válido: 1024–65535). Presione Enter o haga clic fuera para confirmar; los valores fuera de rango se restablecen a4532. - Haga clic en Enable CAT. El texto del botón cambia de "Disabled" a "Enabled" y se resalta en verde cuando está activo.
- Verifique las filas de canales. Cada fila etiquetada como A, B, C o D debe actualizarse de
(stopped)a:<puerto> (0 clients)una vez que los servidores estén escuchando. - En su software de registro o concursos (N1MM, Log4OM, WSJT-X o similar), configure la conexión CAT como rigctld (net) e ingrese
localhost(o la dirección IP del equipo con AetherSDR) y el puerto del canal que desea controlar; por ejemplo,4532para el canal A o4533para el canal B. - Cuando el software externo se conecte, la fila del canal se actualizará a
:<puerto> (1 client).
Qué hace cada control¶
| Control | Valor predeterminado | Rango válido | Clave persistida | Comportamiento |
|---|---|---|---|---|
| Enable CAT | Off | On / Off | CatEnabled |
Inicia o detiene los cuatro servidores TCP rigctld. El texto del botón cambia entre "Disabled" y "Enabled". También escribe el puerto base actual en CatTcpPort. |
| Enable TTY | Off | On / Off | — | Inicia o detiene los enlaces simbólicos PTY para acceso de tipo serie. La ruta del enlace simbólico se muestra por canal. En Linux, las rutas están en $XDG_RUNTIME_DIR/aethersdr/cat-A a cat-D. En macOS, las rutas están en ~/Library/Caches/AetherSDR/cat-A a cat-D. No es necesario para software basado en TCP. |
| Base | 4532 |
1024–65535 | CatTcpPort |
Establece el puerto TCP base. El canal A usa este puerto; B, C y D usan base+1, base+2, base+3. Si los servidores ya están en ejecución, se reinician inmediatamente en los nuevos puertos. |
| Filas de canales (A–D) | (stopped) |
— | — | Muestra el estado TCP de cada canal y el número de clientes conectados. El color de la insignia coincide con el color del slice. La ruta PTY se muestra cuando está habilitada. |
Actualización de seguridad en v26.5.3¶
En v26.5.3, la ubicación del enlace simbólico PTY se movió de /tmp a directorios de tiempo de ejecución por usuario ($XDG_RUNTIME_DIR/aethersdr/ en Linux, ~/Library/Caches/AetherSDR/ en macOS). Este cambio corrige una vulnerabilidad de enlace simbólico entre usuarios (GHSA-qxhr-cwrc-pvrm). El reemplazo atómico de enlaces simbólicos (crear un enlace simbólico temporal y luego renombrarlo) cierra la ventana de ejecución TOCTOU.
Consejos¶
- Si solo usa un programa de registro a la vez, el canal A en el puerto
4532es suficiente. Los canales B–D existen para ejecutar múltiples programas simultáneamente contra diferentes slices. - Para que los servidores TCP se inicien automáticamente cada vez que se inicie AetherSDR, use
Settings > Autostart rigctld with AetherSDR. - Cambiar el valor de Base mientras Enable CAT está activo reinicia todos los servidores en ejecución inmediatamente en los nuevos puertos. Actualice la configuración de puerto de su software de registro para que coincida antes de reconectarse.
- Para acceso PTY, el software externo abre la ruta que se muestra en la fila del canal, que es la misma ubicación donde se crea el enlace simbólico real.
Solución de problemas¶
- La fila del canal permanece en
(stopped)después de hacer clic en Enable CAT — Es probable que otro proceso ya esté escuchando en ese puerto. Elija un puerto base diferente o detenga la aplicación en conflicto. - El software de registro muestra "connection refused" — Confirme que Enable CAT esté activado (el botón muestra "Enabled" en verde) y que esté usando el número de puerto correcto para el canal. Si AetherSDR está en un equipo remoto, use la dirección IP de ese equipo en lugar de
localhost. - El contador de clientes no aumenta — El software se conectó pero se desconectó inmediatamente. Verifique que su software de registro esté configurado en modo rigctld (red), no en un modo serie directo o Hamlib que espere un protocolo diferente.