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 Hzen bandas de UHF (430-440 MHz). - Nivel de Señal RSSI: Estable entre
-90 dBmy-60 dBmen 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)
Etapa 1: Búsqueda y Ajuste de Transmisión (Módem -> Walkie)
- 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. - Abre
MMDVMcalen la consola SSH de tu hotspot. - Pulsa la tecla
m(Modo de tono). - Pulsa la Barra Espaciadora. El LED de transmisión (TX) del módem se encenderá.
- 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.
- Si ocurre el Caso B, mantén la transmisión encendida y presiona las teclas
Fofpoco a poco mientras escuchas la claridad del audio. Toma nota de cuántos impulsos aplicaste para lograr la máxima nitidez. - Desactiva la transmisión presionando la Barra Espaciadora.
Etapa 2: Verificación Digital y Medición del BER (Walkie -> Módem)
- Cambia el walkie-talkie al canal digital DMR asignado para las pruebas.
- En la consola de
MMDVMcal, presiona la teclaqpara entrar en modo de lectura y análisis de recepción. - Pulsa el PTT del walkie-talkie y habla o mantén la transmisión durante 5 segundos.
- 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) - Si el BER devuelto es superior al
0.5%, ajusta el offset con las teclasz/Zhasta que la lectura devuelva valores estables lo más cercanos posible al0.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:
- Iniciamos
MMDVMcale ingresamos al menú de escucha de paquetes pulsandoq. - Pulsamos PTT en el Anytone emitiendo una portadora digital. La consola registra:
DMR Header Found | Offset: +450 Hz | BER: 3.2% - Identificamos que la frecuencia del cristal del hotspot está desplazada +450 Hz por encima de la señal emitida por el portátil.
- Pulsamos la tecla
zrepetidamente hasta corregir el desfase en la lectura en vivo hasta conseguir:DMR Header Found | Offset: +10 Hz | BER: 0.0% - 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:
- Accede a tu panel Web (Ejemplo:
http://pi-star.local/admin/expert/fulledit_mmdvmhost.php). - Entra en la pestaña Configuration -> Expert -> MMDVMHost.
- Desplázate hasta el bloque titulado
[Modem]. - Modifica las variables según los resultados obtenidos en tus pruebas:
[Modem] RXOffset=-450 TXOffset=-450 - Haz clic al final de la página en Apply Changes (Aplicar cambios).
- 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. |