Síntomas comunes

Busca abajo el caso que más se parezca al tuyo. Cada entrada te dice qué registro (log) revisar primero y qué suele estar detrás. Esto es un punto de partida, no un árbol de diagnóstico exhaustivo: lee la línea real del registro que obtengas, porque «Network error» e «Invalid TG» parecen ambos un «está descompuesto», pero significan cosas completamente distintas.

Consulta Usar el Log Viewer si todavía no lo has abierto.

No hay audio en RX ni en TX

Revisa este registro: MMDVMHost

Causas probables:

  • No se seleccionó el tipo de módem, o se seleccionó el equivocado; consulta Sin módem.

  • El desplazamiento (offset) de RX/TX es incorrecto para tu módem; consulta Offset del radio.

  • El módem necesita calibración/ajuste de BER; consulta Calibrar tu módem / Ajustar el BER.

  • La configuración del lado del radio (frecuencia, desplazamiento, DUP, código de color, talkgroup/contacto) no coincide con lo que configuraste en WPSD: es una discrepancia en la programación del radio, no un error de WPSD. Revisa la guía Zero to Hero correspondiente a tu radio.

El hotspot no transmite / no puede transmitir

Revisa este registro: MMDVMHost

Causas probables:

  • Lo mismo que en «no hay audio» arriba: los problemas de desplazamiento, calibración o selección de módem suelen aparecer aquí primero.

  • Configuración de DUP/desplazamiento incorrecta en el radio para un nodo simplex; consulta el consejo sobre «DUP» de D-Star si usas D-Star, aunque la misma lógica (simplex necesita DUP+/DUP- con desplazamiento cero, no «off») aplica en general.

  • El modo está en pausa; consulta Pausar y reanudar modos.

Parrot (u otro enrutamiento) funciona a veces y falla de forma intermitente

Revisa este registro: DMRGateway

Causa probable: Si también tienes sesión iniciada en VoxDMR o QSO One en tu teléfono o PC al mismo tiempo que WPSD, casi seguro es eso, no WPSD. Esas aplicaciones se conectan a BrandMeister con el protocolo BM Rewind (confirmado en VoxDMR; muy probable en QSO One), mientras que WPSD se conecta con el protocolo adecuado, MMDVM/Homebrew Repeater Protocol, y Rewind no parece admitir ESSID en el DMR ID. Con ambos dispositivos llegando a BrandMeister al mismo tiempo con exactamente el mismo DMR ID sin sufijo, BrandMeister no tiene forma de distinguirlos, así que Parrot y otros enrutamientos fallan de forma impredecible.

Solución: Asigna a tu hotspot un ESSID de la red BrandMeister (BrandMeister Network ESSID) único (01-99) en la página de configuración (Configuration) para que se registre como un dispositivo distinto (consulta Colisiones de DMR ID y el campo ESSID), o cierra la sesión de VoxDMR/QSO One mientras usas WPSD. (El equipo de WPSD no da soporte a ninguna de las dos aplicaciones; esto solo describe el mecanismo conocido.)

El indicador Network Status está en rojo

Revisa este registro: el registro del gateway de la red o redes que fallan; por ejemplo, DMRGateway para una red DMR. El motivo específico del rechazo casi siempre está ahí mismo, en el registro.

Causas probables:

  • Reloj del sistema incorrecto. Muchas redes de voz digital rechazan conexiones de un dispositivo cuya hora está muy desfasada, y la mayoría de las SBC no tienen un RTC con batería: si el hotspot se queda sin energía y tarda en reconectarse a Internet (o no se reconecta) antes de intentar conectarse, el reloj puede desfasarse lo suficiente como para causar justo esto. Revisa Admin -> Advanced -> System / Device Details -> Time Synchronization Status: ahí ves si el reloj del sistema realmente está sincronizado y con qué fuente. Una vez que confirmes que hay acceso real a Internet, debería sincronizarse y corregirse solo en uno o dos minutos.

  • Credenciales de red incorrectas: DMR ID o contraseña equivocados para esa red en particular. Cuando esta es la causa, el registro del gateway muestra un rechazo de autenticación, no un tiempo de espera agotado genérico.

  • Problemas generales de red/firewall; consulta Requisitos de firewall y puertos.

  • El reflector/master/host específico está caído o fue depurado de la lista; consulta la entrada «No puedo enlazar/conectarme» de arriba.

El indicador Mode Status está en rojo

Revisa este registro: MMDVMHost. Es un problema distinto del de Network Status de arriba: significa que el propio MMDVMHost no puede comunicarse con el módem/hardware de RF, antes incluso de que intervenga cualquier red.

Causas probables:

  • No se detecta el módem, se seleccionó un tipo de módem equivocado o hay una discrepancia entre módem y firmware; consulta Sin módem y ejecuta sudo wpsd-detectmodem por SSH para confirmar qué está conectado realmente y si su firmware está al día.

  • Conexión física defectuosa o floja con el módem/HAT.

El dashboard muestra una transmisión que nunca termina (TX «atorada»/«fantasma»)

Qué está pasando: Es una falla de visualización, no una transmisión real: tu hotspot en realidad no está atorado transmitiendo. Sucede cuando algo interrumpe a MMDVMHost a mitad de una transmisión (un modo que se pone en pausa, una caída de red, etc.) justo cuando estaba transmitiendo, antes de que tenga oportunidad de registrar que la transmisión terminó. El dashboard lee ese registro para decidir si estás transmitiendo, y sin esa entrada faltante de «fin de transmisión», sigue mostrando TX como activa indefinidamente, aunque en realidad no esté pasando nada en el aire.

Solución: Por SSH, ejecuta:

sudo wpsd-system-manager -fl

Esto limpia las entradas de registro específicas que confunden al dashboard, sin tocar nada más. El indicador atorado debería desaparecer en unos segundos.

Si eso no lo resuelve, hay una opción más a fondo:

sudo wpsd-system-manager -pl

Esto reinicia todos los servicios de WPSD y borra por completo los registros del día (en el dashboard el efecto neto es el mismo que reiniciar el equipo) y siempre lo resuelve.

Nos preguntan esto muy seguido, así que si tu estado de RX/TX se ve «atorado», prueba esto antes de suponer que algo anda realmente mal con tu hotspot o tu radio.

El dashboard no carga / no es accesible

Revisa este registro: vale la pena echarle un vistazo a MMDVMHost (confirma que el equipo en sí está funcionando), pero normalmente es un problema de red, no de un servicio de WPSD; no hay un registro específico del dashboard que puedas ver desde el dashboard si no puedes llegar al dashboard.

Causas probables:

  • http://wpsd.local (o una dirección .local similar) no se resuelve. Esto casi siempre significa que tu red no admite el descubrimiento .local tipo mDNS/Bonjour, algo común en algunos routers, en Wi-Fi de invitados o aislada, y en algunos dispositivos Android. Es una limitación de la red, no una señal de que WPSD no esté funcionando. Busca la IP del hotspot directamente en la lista de dispositivos conectados de tu router y entra con esa dirección.

  • La IP del hotspot cambió (no hay una IP estática/reservada configurada); consulta Darle a tu hotspot una dirección IP fija para la solución a largo plazo y que esto deje de pasar.

  • El Wi-Fi nunca llegó a conectarse después de la configuración inicial; consulta Acceso inicial al dashboard.

  • Si puedes acceder localmente pero no de forma remota, es lo esperado; consulta Requisitos de firewall y puertos para ver qué queda expuesto de forma predeterminada.

Caller Details / Talkgroup Names no aparecen

No es un error: estas funciones operan analizando en tiempo real los registros de MMDVMHost y de los gateways, lo que consume bastante más CPU que las funciones básicas del hotspot. Las placas de un solo núcleo (la Pi Zero W original, la Pi 3A+) no tienen margen suficiente y no son compatibles con estas funciones. Consulta las preguntas frecuentes para la explicación completa. Se necesita una SBC de varios núcleos (Pi 3B/3B+ o más reciente, Pi 4, Pi 5, Zero 2 W, etc.).

La actualización falla, se congela o no se aplica

Revisa este registro: MMDVMHost y los registros de los gateways específicos de los servicios que quizá no se reiniciaron después de la actualización.

Causas probables:

  • En algún momento se desactivó Auto-Updates and Diagnostics; consulta la advertencia en Actualizaciones automáticas y diagnósticos. Esto detiene por completo las actualizaciones sin avisar, no solo las notificaciones.

  • Actualización interrumpida (corte de energía, desconexión a mitad de la actualización); consulta Restablecer WPSD para ver las opciones de recuperación.

Restauré la configuración pero algo sigue mal / se perdió algo tras restaurar

Causas probables:

  • Se hizo doble clic en la restauración o se interrumpió: las restauraciones se ejecutan como un proceso en segundo plano sin bloqueo, y hacer clic dos veces lanza una segunda restauración que se encima con la primera. Consulta Respaldar y restaurar la configuración.

  • Las contraseñas no forman parte del respaldo: restaurar no revierte la contraseña de tu dashboard, deja la actual. La misma sección mencionada arriba lo explica.

MMDVMHost (u otro servicio) se reinicia constantemente / no arranca

Revisa este registro: MMDVMHost, o el del servicio específico que falla; busca el error inmediatamente anterior al reinicio, no solo el hecho de que se esté reiniciando.

Causas probables:

  • No se detecta el módem o el tipo es incorrecto; consulta Sin módem y ejecuta sudo wpsd-detectmodem por SSH para confirmar qué está conectado realmente.

  • Un archivo de configuración editado a mano que choca con lo que espera la página de configuración (Configuration); consulta Cómo administra WPSD las listas de hosts para entender por qué las ediciones a mano y las configuraciones administradas por WPSD no se llevan bien, y Perfiles como tu forma de volver a un estado que sabes que funciona.

Transmisiones duplicadas o «fantasma» / doble transmisión

Revisa este registro: el registro del gateway correspondiente; busca el mismo tráfico enrutado dos veces.

Causas probables:

¿Sigues atorado después de comparar los registros con lo anterior? Es hora de pedir ayuda, y lleva contigo el zip de Descargar todos los registros (Download All Logs).