DOCUMENTACIÓN OFICIAL · ES / EN Manual de Usuario de NetShack Control
Guía completa para instalar, conectar y operar netshack, nsc y netshack-server en Windows, macOS, Linux y Raspberry Pi.
1. Introducción
NetShack Control es un cliente nativo, multiplataforma y de código abierto (GPL-3.0-or-later) para controlar transceptores Icom por red (LAN/WLAN) o mediante servidor remoto USB, con interfaz y documentación bilingües (español e inglés).
netshack Aplicación gráfica de escritorio (nsc-gui) con panel único, espectro y cascada a 30 fps, audio bidireccional, manipulador CW, memorias, macros y soporte de controladores físicos.
nsc Herramienta de línea de comandos (nsc-cli) para automatización, scripts, lectura de medidores y puentes CAT (nsc bridge).
netshack-server Servidor sin interfaz gráfica (nsc-server) para compartir radios conectadas por USB desde un PC o Raspberry Pi con control de permisos y Watchdog de PTT.
2. Instalación y compilación
Descarga el paquete correspondiente a tu sistema operativo desde la página de Releases o compílalo directamente desde el código fuente con Rust 1.85 o superior:
- Windows (x86_64):
netshack-windows-x86_64.zip (incluye netshack.exe, nsc.exe y netshack-server.exe). - macOS (Apple Silicon / Intel):
netshack-macos-arm64.tar.gz o netshack-macos-x86_64.tar.gz. - Linux (x86_64 / ARM64):
sudo dpkg -i netshack-linux-amd64.deb o archivo .tar.gz.
sudo apt install libasound2-dev libudev-dev
cargo build --release --workspace
Para cambiar el idioma de la interfaz gráfica o de la CLI en cualquier momento, utiliza el selector superior derecho en la ventana principal o pasa el argumento --lang es / --lang en.
3. Conexión con la radio
Abre «Radios…» en la barra superior para añadir o seleccionar un equipo de tu libreta de radios:
-
1. LAN / WLAN (Icom UDP): Introduce la IP o nombre del equipo, puerto de control (por defecto 50001), usuario y contraseña. La contraseña se guarda cifrada en el llavero del sistema operativo (Credential Manager, Keychain o Secret Service), nunca en texto plano.
-
2. CI-V por TCP: Ideal para pruebas locales sin hardware usando radio-sim (127.0.0.1:50050) o pasarelas TCP.
🔒 Seguridad de red: El protocolo UDP de Icom no cifra el tráfico. Para operar fuera de tu red local, utiliza siempre una VPN como WireGuard o Tailscale y cumple la normativa de tu licencia de radioaficionado.
4. Operación diaria (VFO, espectro, CW y memorias)
-
Sintonía y VFOs: Gira la rueda del ratón sobre cualquier dígito de la frecuencia o sobre el dial rotatorio para sintonizar. En equipos de doble receptor (IC-7610, IC-9700, IC-7851, IC-7760) activa Dualwatch, M/S y el espectro doble simultáneo.
-
Espectro y cascada: Haz clic o arrastra sobre cualquier señal en el espectro o cascada para sintonizar directamente. Dispone de zoom (1x–8x), retención de picos (Peak Hold) y plan de bandas IARU R1 integrado.
-
CW, memorias de voz y escaneo: En la pestaña «CW / Voz» ajusta tono lateral, velocidad PPM, break-in (OFF/SEMI/FULL), envía texto por teclado y edita 8 macros CW (M1–M8) y 8 memorias de voz (T1–T8). En «Mem / Escaneo» gestiona canales de memoria, escaneos programados y las 12 macros rápidas (P1–P12).
5. Controladores físicos (RC-28, Shuttle, MIDI)
Abre «Controladores…» en la barra superior para configurar superficies de control físico por USB:
-
Icom RC-28: Dial rotatorio USB oficial (VID 0x0C26 / PID 0x001E) con multiplicador dinámico de pasos, PTT momentáneo o conmutado y asignación de acciones a los botones F-1 y F-2.
-
Contour ShuttleXpress / ShuttlePRO v2: Soporte nativo para la rueda central jog, el anillo exterior shuttle de velocidad variable y todos sus botones programables.
-
MIDI y MIDI Learn: Selecciona cualquier puerto MIDI de entrada y pulsa «Aprender Nota → Acción», «Aprender Dial (CC relativo)» o «Aprender Potenciómetro (CC)» para asignar botones, encoders y deslizadores físicos a funciones y niveles de la radio.
6. Integración con terceros (WSJT-X, fldigi, rigctld)
Abre «Integraciones…» en la barra superior (o ejecuta nsc bridge desde la CLI) para compartir la radio simultáneamente con WSJT-X, JTDX, fldigi, GridTracker y libros de guardia:
- Hamlib
rigctld: TCP 4532 (modelo Hamlib 3073 u otro según perfil). - FLRig XML-RPC: TCP
12345. - CI-V crudo por TCP: TCP
50051. - Puerto serie virtual: mediante
nsc bridge --serial <RUTA> con com0com en Windows (\\.\CNCA0) o pty/socat en Linux/macOS (/dev/pts/X).
La ventana «Integraciones…» detecta automáticamente los dispositivos de audio virtual instalados en tu sistema: VB-Cable / Voicemeeter en Windows, BlackHole 2ch en macOS y null-sink de PipeWire o PulseAudio en Linux.
7. Modo servidor remoto (netshack-server)
netshack-server permite operar en remoto cualquier radio conectada por USB (CI-V serie + códec de audio USB), por ejemplo desde una Raspberry Pi:
netshack-server --generate-config /etc/netshack/server.toml
netshack-server --list-audio
netshack-server --config /etc/netshack/server.toml
-
Permisos por operador: Cada usuario en server.toml tiene can_tx = true (control con transmisión) o can_tx = false (modo solo escucha).
-
Watchdog de PTT: Corta la transmisión al instante si se pierde el keepalive del cliente o si se supera el temporizador máximo de transmisión TOT (ptt_tot_secs).