🛠️ MANUAL TÉCNICO DE INFRAESTRUCTURA

Guía Definitiva de Configuración de MMDVM.ini

Manual de Instrumentación y Parámetros: Configuración avanzada de nodos domésticos, hotspots y repetidores digitales para C4FM, DMR, D-STAR y redes IP.

1. Introducción al Ecosistema MMDVM

El proyecto MMDVM (Multi-Mode Digital Voice Modem), concebido originalmente por Jonathan Naylor (G4KLX), revolucionó la radioafición moderna al actuar como un puente de hardware y software abierto capaz de sintetizar y decodificar múltiples modulaciones digitales sobre transceptores analógicos tradicionales o módems dedicados.

El núcleo del sistema operativo de estas estaciones (ya sean compuestas por una Raspberry Pi, un PC industrial o una placa Pi-Hat) es el demonio MMDVMHost. Toda la lógica de enrutamiento, temporización, calibración de radiofrecuencia, gestión de puertos e interconexión con redes como BrandMeister, YSF (System Fusion) o FCS se gobierna mediante un único archivo de comandos: MMDVM.ini.

📌 Objetivo de esta guía: Desglosar la estructura del archivo MMDVM.ini paso a paso, explicando el impacto de cada variable crítica para garantizar una emisión limpia, sin errores de modulación (BER bajo) y con conexión estable a los reflectores.

2. Identificación y Parámetros Generales: [General]

El bloque [General] establece las credenciales operativas del nodo. Un error en esta sección impedirá la autenticación del Hotspot en los servidores globales.

[General]
Callsign=EA6AAA            ; Tu indicativo oficial de radioaficionado (Sin SSID)
Id=2141234                 ; Tu ID de RadioID.net de 7 dígitos (Obligatorio para DMR)
Timeout=180                ; Temporizador TOT máximo por transmisión (en segundos)
Duplex=0                   ; 0 = Modo Simplex (Hotspot común) | 1 = Modo Dúplex (Repetidor)
Display=Nextion            ; Interfaz gráfica: None, OLED, Nextion, HD44780, TFT Serial
Daemon=1                   ; 1 = Ejecutar como servicio de sistema en segundo plano
  • Duplex: Si utilizas una placa de dos antenas o un repetidor con frecuencias divididas (TX/RX), debes asignarle el valor 1. Para un hotspot monobanda tradicional de una sola antena, mantén el valor 0.
  • Timeout: Evita el bloqueo de la frecuencia en caso de fallo en el PTT del transmisor.

3. Telemetría y Posicionamiento: [Info]

La sección [Info] transmite los datos técnicos de tu estación hacia las pasarelas APRS y los mapas de cobertura interactivos.

[Info]
RXFrequency=438000000       ; Frecuencia de Recepción expresada en HERTZIOS (Ej: 438.000 MHz)
TXFrequency=438000000       ; Frecuencia de Transmisión en Hertzios (En Simplex = RX)
Power=10                    ; Potencia estimada del equipo en Vatios (Watts)
Latitude=39.5696            ; Coordenada de Latitud en formato decimal
Longitude=2.6502            ; Coordenada de Longitud en formato decimal
Height=15                   ; Altura de la antena sobre el nivel del suelo (metros)
Location=Mallorca, EA6      ; Descripción geográfica corta del QTH
Description=Nodo C4FM/DMR   ; Identificador público de la estación
URL=https://c4fmmallorca.com; Sitio web o enlace de referencia

⚠️ Atención a las Frecuencias: Las frecuencias no se introducen en Megahertzios. Debes multiplicar la frecuencia por 1.000.000. Por ejemplo, 438.500 MHz debe escribirse exactamente como 438500000.

4. Comunicación por Hardware y Calibración BER: [Modem]

Esta es una de las secciones más críticas. Define la interfaz de comunicación en el bus serie de la Raspberry Pi o PC, así como el ajuste fino de offset para minimizar la tasa de error de bits (BER - Bit Error Rate).

[Modem]
Port=/dev/ttyAMA0           ; Puerto GPIO interno en Pi-Hats (/dev/ttyUSB0 en conexiones USB)
Baud=115200                 ; Velocidad de transferencia serie
RXInvert=0                  ; Inversión de fase en RX (0 o 1 según placa/módem)
TXInvert=1                  ; Inversión de fase en TX (Generalmente 1 en la mayoría de módems)
ChannelTXDelay=100          ; Retardo en ms para la apertura de la portadora
RXOffset=0                  ; Desplazamiento de frecuencia en RX para ajuste de BER
TXOffset=0                  ; Desplazamiento de frecuencia en TX para ajuste de BER

🛠️ Cómo ajustar el RX/TX Offset

Si al transmitir observas que tu walkie muestra un BER superior al 1.5% o el audio se entrecorta, debes corregir la desviación del cristal de cuarzo del módem modificando los valores de RXOffset y TXOffset en pasos de ±100 (Ej: RXOffset=300) hasta obtener un BER cercano al 0.0%.

🔌 Mapeo de Puertos Serie

• /dev/ttyAMA0: Conexión GPIO en Pi3/Pi4/Pi5.
• /dev/ttyS0: Raspberry Pi Zero / W.
• /dev/ttyUSB0: Módems MMDVM conectados por USB externo.

5. Activación de Protocolos Digitales

Dentro del archivo MMDVM.ini existen bloques individuales para cada protocolo. Solo debes activar aquellos modos que tu hardware o tu operativa requieran asignando Enable=1.

[System Fusion] — C4FM

[System Fusion]
Enable=1                   ; 1 = Activado | 0 = Desactivado
LowDeviation=0            ; 1 solo si tu transmisor usa desviación reducida

[DMR] — Digital Mobile Radio

[DMR]
Enable=1                   ; 1 = Activado | 0 = Desactivado
ColorCode=1                ; Código de Color asignado (Normalmente 1)
SelfOnly=0                 ; 0 = Permite el uso público a otros colegas

6. Configuración de Redes e Interconexión IP

Para enlazar la RF local con los servidores globales, se deben configurar los apartados de red correspondientes.

A) Configuración para Redes DMR (BrandMeister / DMR+)

[DMR Network]
Enable=1                    ; Activa la interconexión IP para DMR
Type=Direct
Address=master.brandmeister.es ; Nombre o IP del servidor servidor Mástil
Port=62031                  ; Puerto de enlace estándar para BrandMeister
Password=TU_CONTRASEÑA_SELFCARE ; ⚠️ ¡OBLIGATORIO! Contraseña de Hotspot establecida en BrandMeister
Callsign=EA6AAA             ; Tu indicativo
Id=2141234                  ; Tu ID DMR de 7 dígitos
Debug=0

B) Configuración para C4FM (YSFGateway / Wires-X / Reflectores)

[System Fusion Network]
Enable=1                    ; Activa la interconexión IP para C4FM
LocalAddress=127.0.0.1      ; Conexión local en el bucle del sistema
LocalPort=32000             ; Puerto UDP local
G2HandlerAddress=127.0.0.1
G2HandlerPort=60000
Debug=0

7. Resumen de Errores Críticos y Soluciones

Síntoma / Error Causa Probable Solución en MMDVM.ini
El Hotspot no conecta a BrandMeister Falta la contraseña de seguridad Self-Care. Configurar Password= exactamente igual que en la web de BrandMeister.
Alto nivel de BER (> 3%) y audio robótico Desviación de frecuencia en el cuarzo del módem. Ajustar RXOffset y TXOffset en la sección [Modem].
El PTT no transmite hacia el transceptor Inversión de TX o puerto serie incorrecto. Verificar TXInvert=1 y validar la ruta del puerto en Port=.
La pantalla Nextion/OLED no enciende Driver de pantalla mal seleccionado. Verificar la línea Display= dentro del bloque [General].

// C4FM MALLORCA :: TELEMETRÍA Y SISTEMAS DE RADIO DE PRECISIÓN

Documentación técnica elaborada por la sección de ingeniería de C4FM Mallorca.