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)

Operación diaria en NetShack Control
  • 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).