Manual Profesional Completo de MMDVMcal: Guía Avanzada de Calibración

Manual de Referencia Avanzado: MMDVMcal

Manual operativo completo para la calibración de radiofrecuencia en nódulos, repetidores y hotspots digitales (DMR, Yaesu C4FM, D-Star, P25, NXDN). Incluye metodologías de laboratorio y procedimientos paso a paso de uso real.

1. Fundamentos Técnicos y Teoría del Problema

En las comunicaciones digitales por radioafición, la información codificada no viaja en forma de variaciones de amplitud o frecuencia puramente analógicas, sino mediante desplazamientos discretos de fase o frecuencia (FSK / 4FSK). La precisión de los osciladores locales (TCXO) en los módems MMDVM determina la tasa de lectura correcta de las tramas de datos.

¿Qué ocurre sin calibrar?

  • Desfase Térmico (Deriva): El oscilador cambia de frecuencia al calentarse el módem.
  • Pérdida de tramas DMR: Sincronización errónea entre los Time Slots (TS1 / TS2).
  • BER Elevado: Tasa de error de bits superior al 1.5%-2.0%, provocando audio robotizado o silencios involuntarios.

Métrica de Calidad Esperada

  • BER Objetivo: Menor a 0.3%.
  • Desviación Máxima tolerada: Menos de ±100 Hz en bandas de UHF (430-440 MHz).
  • Nivel de Señal RSSI: Estable entre -90 dBm y -60 dBm en recepción local.

2. Entorno Operativo, Requisitos e Instalación

2.1. Preparación del Sistema Operativo (Pi-Star / WPSD / Linux Debian)

Para poder manipular el módem mediante MMDVMcal, es totalmente indispensable que ningún proceso en segundo plano mantenga abierto el puerto serie asignado (usualmente /dev/ttyAMA0, /dev/ttyS0 o /dev/ttyUSB0).

Paso 1: Conéctate mediante SSH o abre una terminal local.

ssh Esta dirección de correo electrónico está siendo protegida contra los robots de spam. Necesita tener JavaScript habilitado para poder verlo.

Paso 2: Pasa a modo de escritura en el sistema de archivos (en distribuciones Pi-Star):

rpi-rw

Paso 3: Detén el servicio MMDVMHost y cualquier pantalla secundaria como NextionExec:

sudo systemctl stop mmdvmhost.timer
sudo systemctl stop mmdvmhost
sudo pistar-mmdvmhost stop

2.2. Ejecución Directa de MMDVMcal

Según tu plataforma o sombrero MMDVM instalado, invoca la herramienta señalando el puerto o el fichero de configuración de la pasarela:

Opción A Ejecución estándar leyendo el archivo de configuración activo:

sudo MMDVMcal /etc/mmdvmhost

Opción B Ejecución directa sobre el puerto GPIO serie principal:

sudo MMDVMcal /dev/ttyAMA0

Opción C Ejecución sobre un módem conectado por USB:

sudo MMDVMcal /dev/ttyUSB0

3. Diccionario Interactivo de Comandos del Programa

Al iniciar la aplicación, la consola de comandos quedará a la espera de instrucciones de una sola tecla (sensibles a mayúsculas/minúsculas):

Tecla Función Exacta Uso Recomendado en Laboratorio / Campo
h / H Menú de Ayuda (Help) Muestra en pantalla la lista rápida de parámetros interactivos.
m / M Modo DMR Carrier / Tono de 1031 Hz Esencial para novatos: Genera un tono analógico continuo para medir desviación o buscar con el walkie en modo FM.
d / D Patrón de Pruebas DMR Simplex Genera una trama de modulación digital real DMR para medir la tasa BER en el transmisor.
b / B Prueba DMR DUPLEX (Slot 1 / Slot 2) Activa la transmisión alternando ranuras de tiempo (Ideal para repetidores y placas Duplex).
q / Q Modo de Recepción (Rx Test) Pone la placa en escucha continua para calibrar la recepción analizando paquetes del walkie.
f Disminuir Frecuencia (-50 Hz) Ajusta hacia abajo la portadora de prueba en saltos finos.
F Aumentar Frecuencia (+50 Hz) Ajusta hacia arriba la portadora de prueba en saltos finos.
Z / z Modificar el Offset de Frecuencia Incrementa o decrementa directamente el valor absoluto de desvío del cristal (TCXO Offset).
Espacio PPT (Key-Up / Key-Down) Activa o Desactiva la Transmisión: Pulsa para empezar a transmitir el tono seleccionado y vuelve a pulsar para apagar.
Esc Salir del Programa Cierra MMDVMcal liberando el módem para volver al sistema operativo.

4. Procedimiento Práctico de Calibración Réal (Walkie + Hotspot)

Recomendación Previa: Mantén tu walkie-talkie a una distancia mínima de 2 a 3 metros del hotspot para evitar la saturación del receptor por campo cercano (RF Overload). Retira antenas de alta ganancia o usa potencias reducidas (Low Power = 1W / 0.5W) en tu portátil.

Etapa 1: Búsqueda y Ajuste de Transmisión (Módem -> Walkie)

  1. Configura una canal analógico (VFO / FM) en tu walkie-talkie con la frecuencia exacta asignada a tu hotspot (Ejemplo: 438.800.00 MHz). Asegúrate de tener el squelch (silenciador) abierto o al nivel 1.
  2. Abre MMDVMcal en la consola SSH de tu hotspot.
  3. Pulsa la tecla m (Modo de tono).
  4. Pulsa la Barra Espaciadora. El LED de transmisión (TX) del módem se encenderá.
  5. Escucha en el walkie-talkie:
    • Caso A (Perfecto): Escuchas un tono constante de pitido claro y nitido.
    • Caso B (Frecuencia corrida): Escuchas ruido de fondo, chasquidos o silbidos distorsionados.
  6. Si ocurre el Caso B, mantén la transmisión encendida y presiona las teclas F o f poco a poco mientras escuchas la claridad del audio. Toma nota de cuántos impulsos aplicaste para lograr la máxima nitidez.
  7. Desactiva la transmisión presionando la Barra Espaciadora.

Etapa 2: Verificación Digital y Medición del BER (Walkie -> Módem)

  1. Cambia el walkie-talkie al canal digital DMR asignado para las pruebas.
  2. En la consola de MMDVMcal, presiona la tecla q para entrar en modo de lectura y análisis de recepción.
  3. Pulsa el PTT del walkie-talkie y habla o mantén la transmisión durante 5 segundos.
  4. Observa la consola de la terminal SSH. Aparecerán líneas de diagnóstico en tiempo real indicando el nivel de BER registrado por el módem:
    DMR RX Frame: BER: 0.0%  RSSI: -65dBm  Offset: -120Hz
    DMR RX Frame: BER: 0.2%  RSSI: -64dBm  Offset: -115Hz
    DMR RX Frame: BER: 1.8%  RSSI: -67dBm  Offset: -350Hz --> (Requiere Ajuste)
  5. Si el BER devuelto es superior al 0.5%, ajusta el offset con las teclas z / Z hasta que la lectura devuelva valores estables lo más cercanos posible al 0.0%.

5. Caso Práctico Resuelto de Extremo a Extremo

Escenario de Ejemplo:

Disponemos de una placa hotspot Duplex conectada a una Raspberry Pi 4. Al intentar usar el portátil (DMR Retevis RT3S / Anytone D878UV), el indicador de recepción del walkie parpadea pero el audio no abre y en el dashboard de Pi-Star se lee un BER: 3.4%.

Pasos de Resolución Ejecutados:

  1. Iniciamos MMDVMcal e ingresamos al menú de escucha de paquetes pulsando q.
  2. Pulsamos PTT en el Anytone emitiendo una portadora digital. La consola registra:
    DMR Header Found | Offset: +450 Hz | BER: 3.2%
  3. Identificamos que la frecuencia del cristal del hotspot está desplazada +450 Hz por encima de la señal emitida por el portátil.
  4. Pulsamos la tecla z repetidamente hasta corregir el desfase en la lectura en vivo hasta conseguir:
    DMR Header Found | Offset: +10 Hz | BER: 0.0%
  5. Anotamos el resultado final: RXOffset = -450 y TXOffset = -450.

6. Guardar la Configuración Definitiva

Cierra la utilidad presionando la tecla Esc o q de forma limpia. Los valores modificados durante la ejecución de MMDVMcal son temporales en la memoria RAM y deben registrarse permanentemente en la configuración de la pasarela.

Si utilizas el panel Web de Pi-Star / WPSD:

  1. Accede a tu panel Web (Ejemplo: http://pi-star.local/admin/expert/fulledit_mmdvmhost.php).
  2. Entra en la pestaña Configuration -> Expert -> MMDVMHost.
  3. Desplázate hasta el bloque titulado [Modem].
  4. Modifica las variables según los resultados obtenidos en tus pruebas:
    [Modem]
    RXOffset=-450
    TXOffset=-450
  5. Haz clic al final de la página en Apply Changes (Aplicar cambios).
  6. Reinicia el servicio MMDVMHost desde la consola o mediante el botón de reinicio de la web:
    sudo pistar-mmdvmhost start

7. Solución de Problemas Frecuentes (Troubleshooting)

Síntoma / Error Causa Probable Solución Sugerida
Unable to open /dev/ttyAMA0 El puerto serie está siendo ocupado por el proceso principal de MMDVMHost. Ejecuta el comando sudo pistar-mmdvmhost stop antes de lanzar la utilidad MMDVMcal.
El walkie no recibe el tono al pulsar Espacio. Frecuencia configurada errónea o potencia de TX insuficiente en el módem. Revisa la frecuencia por defecto configurada en el archivo de texto /etc/mmdvmhost.
BER bajo en frío, pero BER alto tras 15 minutos de uso. Deriva térmica en el cristal oscilador de la placa MMDVM por falta de TCXO de precisión. Coloca un disipador de aluminio sobre el integrado principal o instala un pequeño ventilador de 5V.
Error de permisos denegados al ejecutar. Se está intentando lanzar la herramienta sin privilegios de superusuario. Añade siempre el prefijo sudo antes de llamar a MMDVMcal.
Resumen de Seguridad Operativa: Una calibración limpia garantiza una transmisión espectralmente pura, respetando el ancho de banda canalizado (12.5 kHz en DMR) y evitando interferir en canales o frecuencias adyacentes dentro de las bandas de radioaficionado.