Active el CAT TCP 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 concurso 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 de Hamlib NET rigctl, eliminando la necesidad de un puente rigctld independiente. Use esta página para iniciar esos servidores y dirigir su software de registro al puerto correcto.
Antes de comenzar¶
- AetherSDR debe estar conectado a la radio. El applet CAT requiere una conexión de radio activa.
- 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 vuelven a4532. - Haga clic en Enable TCP. El botón se resalta en verde cuando está activo.
- Verifique las filas de canales. Cada fila etiquetada A, B, C o D debería actualizarse de
(stopped)a:<puerto> (0 clients)una vez que los servidores estén escuchando. - En su software de registro o concurso (N1MM, Log4OM, WSJT-X o similar), configure la conexión CAT como rigctld (net) e ingrese
localhost(o la dirección IP de la máquina con AetherSDR) y el puerto para el 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 TCP | Off | On / Off | — | Inicia o detiene los cuatro servidores TCP rigctld. También escribe el puerto base actual en CatTcpPort. |
| Enable TTY | Off | On / Off | — | Inicia o detiene 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 bajo $XDG_RUNTIME_DIR/aethersdr/cat-A hasta cat-D. En macOS, las rutas están bajo ~/Library/Caches/AetherSDR/cat-A hasta 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 recuento 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 trasladó de /tmp a directorios 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 lance AetherSDR, use
Settings > Autostart rigctld with AetherSDR. - Cambiar el valor de Base mientras Enable TCP está activo reinicia todos los servidores en ejecución inmediatamente en los nuevos puertos. Actualice la configuración del puerto en su software de registro para que coincida antes de reconectar.
- 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
(stopped)después de hacer clic en Enable TCP — Es probable que otro proceso ya esté escuchando en ese puerto. Elija un puerto base diferente o detenga la aplicación conflictiva. - El software de registro muestra "connection refused" — Confirme que Enable TCP esté activado (el botón está verde) y que esté usando el número de puerto correcto para el canal. Si AetherSDR está en una máquina remota, use la dirección IP de esa máquina en lugar de
localhost. - El recuento 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.