Archivo de configuración de DMRGateway¶

DMRGateway permite conectar hasta 6 redes DMR distintas a un mismo sistema MMDVM. Una de las redes se define como un reflector XLX, mientras que las otras cinco pueden ser cualquier combinación de DMR+, BrandMeister, TGIF o sistemas HBLink locales.

El software usa reglas de reescritura (rewrite rules) en la definición de cada red DMR para reasignar los números de talkgroup de cada red a un solo rango numérico, de modo que todas las redes activadas se presentan al radio DMR cliente como si fueran una sola red. Estas reglas de reescritura se documentan en el capítulo Reglas de reescritura de DMRGateway.

Este capítulo revisa todas las demás opciones del archivo DMRGateway.

Empecemos por ver un archivo DMRGateway completo:

[General]
RptAddress=127.0.0.1
RptPort=62032
LocalAddress=127.0.0.1
LocalPort=62031
RuleTrace=0
Daemon=1
Debug=0
RFTimeout=20
NetTimeout=20
Suffix=R

[Log]
DisplayLevel=0
FileLevel=1
FilePath=/var/log/pi-star
FileRoot=DMRGateway

[Voice]
Enabled=1
Language=en_US
Directory=/usr/local/etc/DMR_Audio

[Info]
Enabled=0
RXFrequency=431150000
TXFrequency=431150000
Power=1
Latitude=0.0
Longitude=0.0
Height=0
Location="Town, L0C4T0R"
Description="Country"
URL=https://w0chp.radio

[XLX Network]
Enabled=0
Startup=493
File=/usr/local/etc/XLXHosts.txt
Port=62030
Password=passw0rd
ReloadTime=60
Slot=2
TG=6
Base=64000
Relink=60
Debug=0
Id=1234567
UserControl=1
Module=E

[DMR Network 1]
Enabled=0
Address=3102.master.brandmeister.network
Port=62031
TGRewrite0=2,9,2,9,1
PCRewrite0=2,94000,2,4000,1001
TypeRewrite0=2,9990,2,9990
SrcRewrite0=2,4000,2,9,1001
PassAllPC0=1
PassAllTG0=1
PassAllPC1=2
PassAllTG1=2
Password="passw0rd"
Id=1234567
Debug=0
Location=1
Name=BM_3102_United_States

[DMR Network 2]
Enabled=0
Address=usacentral.ddns.net
Port=62031
TGRewrite0=2,8,2,9,1
PCRewrite0=2,84000,2,4000,1001
Password="passw0rd"
Id=1234567
Debug=0
Location=0
Name=FreeDMR_USA-Central
PCRewrite1=1,8009990,1,9990,1
PCRewrite2=2,8009990,2,9990,1
PCRewrite3=1,4000001,1,1,999999
PCRewrite4=2,4000001,2,1,999999
TypeRewrite1=1,8009990,1,9990
TypeRewrite2=2,8009990,2,9990
TGRewrite1=1,8000001,1,1,999999
TGRewrite2=2,8000001,2,1,999999
SrcRewrite1=1,9990,1,8009990,1
SrcRewrite2=2,9990,2,8009990,1
SrcRewrite3=1,1,1,8000001,999999
SrcRewrite4=2,1,2,8000001,999999

[DMR Network 3]
Enabled=0
Name=HBLink
Address=1.2.3.4
Port=5555
TGRewrite=2,11,2,11,1
Password="PASSWORD"
Location=0
Debug=0
#Id=specific_id
TGRewrite0=2,11,2,11,1

[DMR Network 4]
Enabled=0
Address=tgif.network
Port=62031
PCRewrite0=1,4009990,1,9990,1
PCRewrite1=2,4009990,2,9990,1
TypeRewrite0=1,4009990,1,9990
TypeRewrite1=2,4009990,2,9990
TGRewrite0=1,4000001,1,1,999999
TGRewrite1=2,4000001,2,1,999999
SrcRewrite0=1,9990,1,4009990,1
SrcRewrite1=2,9990,2,4009990,1
SrcRewrite2=1,1,1,4000001,999999
SrcRewrite3=2,1,2,4000001,999999
Password="passw0rd"
Location=1
Name=TGIF_Network
Debug=0

[DMR Network 5]
#Id=specific_id
Address=dmr.freestar.network
Password="passw0rd"
Port=62031
Name=SystemX_United_Kingdom
TGRewrite0=2,4,2,9,1
PCRewrite0=2,44000,2,4000,1001
PCRewrite1=1,4009990,1,9990,1
PCRewrite2=2,4009990,2,9990,1
TypeRewrite1=1,4009990,1,9990
TypeRewrite2=2,4009990,2,9990
TGRewrite1=1,4000001,1,1,999999
TGRewrite2=2,4000001,2,1,999999
SrcRewrite1=1,9990,1,4009990,1
SrcRewrite2=2,9990,2,4009990,1
SrcRewrite3=1,1,1,4000001,999999
SrcRewrite4=2,1,2,4000001,999999
Options="RelinkTime=30;UserLink=1;TS1_1=2350;"
Enabled=1
Location=0
Debug=0
PCRewrite3=1,4000001,1,1,999999
PCRewrite4=2,4000001,2,1,999999

[DMR Network Custom]
#Id=specific_id
Enabled=0
WPSD_AutoRewrites=1
Name=W0CHP_DMR
Address=urf493.w0chp.radio
Port=62030
Password="passw0rd"
TGRewrite0=2,11,2,9,1
TGRewrite1=1,9000001,1,1,999999
TGRewrite2=2,9000001,2,1,999999
PCRewrite0=2,94000,2,4000,1001
PCRewrite1=1,9000001,1,1,999999
PCRewrite2=2,9000001,2,1,999999
TypeRewrite1=1,9009990,1,9990
TypeRewrite2=2,9009990,2,9990
SrcRewrite1=1,1,1,9000001,999999
SrcRewrite2=2,1,2,9000001,999999
Location=0
Debug=0


[GPSD]
Enable=0
Address=127.0.0.1
Port=2947

[APRS]
Enable=0
Address=127.0.0.1
Port=8673
Suffix=D
Description=APRS for DMRGateway
Symbol="Wi"

[Dynamic TG Control]
Enabled=1
Port=3769

[Remote Control]
Enable=1
Port=7643
Address=127.0.0.1

[DMR Network 5]
Location=0
Debug=0
Id=1234567
Address=usa.freestar.network
Password="passw0rd"
Port=62031
Name=SystemX_United_States
TGRewrite0=2,4,2,9,1
PCRewrite0=2,44000,2,4000,1001
PCRewrite1=1,4009990,1,9990,1
PCRewrite2=2,4009990,2,9990,1
PCRewrite3=1,4000001,1,1,999999
PCRewrite4=2,4000001,2,1,999999
TypeRewrite1=1,4009990,1,9990
TypeRewrite2=2,4009990,2,9990
TGRewrite1=1,4000001,1,1,999999
TGRewrite2=2,4000001,2,1,999999
SrcRewrite1=1,9990,1,4009990,1
SrcRewrite2=2,9990,2,4009990,1
SrcRewrite3=1,1,1,4000001,999999
SrcRewrite4=2,1,2,4000001,999999
Enabled=0

Secciones de DMRGateway¶

El archivo de configuración de DMRGateway es un archivo de estilo ini con secciones definidas que configuran distintas opciones del programa. Las secciones son:

[General]¶

Esta sección configura las opciones globales de DMRGateway.

[General]¶
Opción	Predeterminado	Descripción
RptAddress=`<dirección IP>`	`127.0.0.1`	Conectarse a esta instancia de MMDVMHost. Normalmente es `127.0.0.1`, a menos que ejecutes MMDVMHost en otro equipo.
RptPort=`<número de puerto>`	`62032`	Conectarse a este puerto de la instancia de MMDVMHost.
LocalAddress=`<dirección IP>`	`127.0.0.1`	Usar esta dirección local para la conexión. Normalmente es `127.0.0.1`; sin embargo, si te conectas a MMDVMHost en otro equipo, puedes usarla para dirigir la conexión por una interfaz en particular.
LocalPort=`<número de puerto>`	`62031`	Usar este puerto local para la conexión. Asegúrate de que el puerto indicado no esté ya en uso.
RuleTrace=`[0\	`0`	Activa el rastreo de las reglas de reescritura en los registros (logs). 0=False, 1=True.
Daemon=`[0\	`0`	Ejecutar el programa DMRGateway como daemon en segundo plano.
Debug=`[0\	`0`	Activar registro de depuración adicional.
RFTimeout=`<entero>`	`10` segundos	Cuando el usuario inicia tráfico, el timeslot involucrado queda vinculado exclusivamente a esa red DMR durante un breve periodo. Esto evita que otras redes DMR interfieran con la conversación. Estas opciones configuran cuánto tiempo queda vinculado ese slot a esa red DMR, según de dónde vino la última transmisión.
NetTimeout=`<entero>`	`10` segundos	Cuando el tráfico llega por una red DMR (Net), el timeslot involucrado queda vinculado exclusivamente a esa red DMR durante un breve periodo. Esto evita que otras redes DMR interfieran con la conversación. Estas opciones configuran cuánto tiempo queda vinculado ese slot a esa red DMR, según de dónde vino la última transmisión.

[Log]¶

Esta sección define las opciones generales de registro (logging) del daemon DMRGateway.

Los niveles de registro son:

0 - Desactivado
1 - Depuración
2 - Mensaje
3 - Información
4 - Advertencia
5 - Error
6 - Fatal

[Log]¶
Opción	Predeterminado	Descripción
DisplayLevel=`<entero>`	`0`	Define el nivel de registro de DMRGateway que se muestra en la terminal. Si DMRGateway se ejecuta como daemon, esto se desactiva.
FileLevel=`<entero>`	`0`	Define el nivel de registro de DMRGateway para lo que se escribe en el archivo de registro.
FilePath=`<ruta de archivo>`	Ninguno	Define el directorio donde se guardan los archivos de registro.
FileRoot=`<cadena>`	Ninguno	Define la primera parte del nombre del archivo de registro. El nombre del archivo será `<FilePath>/<FileRoot>-YYYY-mm-dd.log` si FileRotate (abajo) es verdadero, o solo FileRoot si es falso.
FileRotate=`[0\	`1` (activado)	Permite que DMRGateway rote los archivos de registro cada día.

[Voice]¶

Esta sección activa los avisos de voz por el aire y selecciona qué idioma usar de entre los archivos ambe precodificados disponibles.

[Voice]¶
Opción	Predeterminado	Descripción
Valor predeterminado	`1`	Activar los avisos.
Language=`<idioma>`	en_GB	Qué idioma usar. Están en formato de idioma ISO, pero actualmente solo hay 11 idiomas con su archivo de avisos ambe correspondiente. Revisa el directorio indicado abajo para ver los actuales. NOTA: aunque DMRGateway en sí usa en_GB de forma predeterminada, WPSD cambia este valor predeterminado a en_US.
Ninguno	Ninguno	Dónde están los archivos de avisos ambe y sus índices asociados. En WPSD normalmente es `/usr/local/etc/DMR_Audio`.

[Info]¶

Algo de información de la estación. Esta información solo se usa para enviar actualizaciones a APRS-IS si esa función está activada. No se usa para nada más.

[Info]¶
Opción	Predeterminado	Descripción
Valor predeterminado	Ninguno	La frecuencia, en Hz, en la que escucha el radio. NOTA: DMRGateway no la usa. Se incluye para que la use WPSD.
TXFrequency=`<frecuencia en hertz>`	Ninguno	La frecuencia, en Hz, en la que transmite el radio. NOTA: DMRGateway no la usa. Se incluye para que la use WPSD.
Power=`<entero>`	`0`	Potencia de salida del radio en watts. NOTA: DMRGateway no la usa. Se incluye para que la use WPSD.
Latitude=`<grados decimales con signo>`	`0.0`	La latitud de la estación. Se indica en grados decimales con el prefijo `-` para el sur del ecuador y sin prefijo para el norte del ecuador. Por ejemplo, Canberra, Australia, está en `-35.28000`.
Longitude=`<grados decimales con signo>`	`0.0`	La longitud de la estación. Se indica en grados decimales con el prefijo `-` para el oeste del Meridiano Internacional de Referencia (el antiguo meridiano de Greenwich) y sin prefijo para el este del Meridiano Internacional de Referencia. Por ejemplo, Santiago, Chile, está en `-70.65047`.
Height=`<altura sobre el NMM en metros>`	`0`	Altura de la estación sobre el nivel medio del mar, en metros.
Ninguno	Ninguno	Una cadena corta de texto libre que identifica dónde estás.
Ninguno	Ninguno	Una cadena corta de texto libre que describe tu estación.
URL=`<URL>`	Ninguno	Un enlace al sitio web de tu estación.

[XLX Network]¶

Esta sección configura las conexiones a la red de reflectores XLX.

[XLX Network]¶
Opción	Predeterminado	Descripción
Tabla: [XLX Network]	`0`	Activa la función de enlace a XLX.
Startup=`<entero>`	`4000`	Indica el servidor XLX al que se conectará automáticamente cuando expire el temporizador `Relink`. `4000` indica que no se enlace.
Ninguno	Ninguno	Este archivo contiene la correspondencia entre los reflectores XLX y su dirección IPv4. WPSD lo actualiza con regularidad. Aunque el software no tiene un valor predeterminado, por convención el nombre de este archivo es `XLXHosts.txt`.
Port=`<número de puerto>`	`62030`	Puerto remoto del servidor XLX al que conectarse.
Local=`<número de puerto>`	`0`	Número de puerto local desde el que saldrán los paquetes UDP. No debe usarlo nada más. Si es `0`, se usará un puerto aleatorio.
Password=`<cadena>`	`passw0rd`	Una contraseña personalizada para el servidor XLX al que te conectas. Solo se necesita si el servidor XLX la exige.
ReloadTime=`<entero en minutos>`	`60`	Tiempo, en minutos, para que DMRGateway vuelva a cargar el archivo XLXHosts.
Slot=`[1\	`2`	Slot DMR en el que se reciben/transmiten (RX/TX) las transmisiones de XLX.
TG=`<número de talkgroup entero>`	`8`	Es el número de talkgroup que usas para comunicarte con los reflectores XLX. DMRGateway tiene un valor predeterminado fijo de `8`, pero en WPSD se cambia a `6` mediante el archivo de configuración predeterminado. Lo que transmitas en este talkgroup se enviará al reflector, y es donde aparece el audio recibido.
Base=`<entero>`	`84000`; se cambia a `64000` en el archivo de configuración predeterminado de WPSD	Es el número base de llamada privada que se usa para controlar que DMRGateway se conecte a un reflector o se desconecte de él. Para usarlo, haz una llamada privada a la base (es decir, 84000 en este ejemplo) para desconectarte del reflector actual. Haz una llamada privada a `base+<número de reflector>` para conectarte a ese reflector; por ejemplo, haz una llamada privada al 64301 (con la configuración predeterminada de WPSD) para conectarte a XLX301.
Module=`<carácter A-Z>`	`None`; la configuración predeterminada de WPSD es `E`	Los reflectores XLX pueden tener hasta 26 módulos separados, y cada uno se comporta como un «canal» distinto. Esto indica a qué módulo conectarse cuando el reflector XLX se enlaza automáticamente.
Relink=`<entero en minutos>`	`0`; el valor predeterminado de WPSD es 60 minutos.	Indica cuánto tiempo esperará DMRGateway sin tráfico de RF ni de red antes de volver a conectarse al reflector predeterminado, si hay uno configurado.
Debug=`[0\	`0`	Activa salida de depuración adicional en el registro de DMRGateway.
Id=`<DMR ID entero>`	`0`	Qué DMR ID presentar al reflector XLX. `0` toma tu DMR ID de MMDVMHost.
UserControl=`[0\	`1`	Permite que los usuarios controlen el enlace a XLX desde el lado del radio.

[DMR Network `x`]¶

Esta sección configura las conexiones a varias redes DMR. DMRGateway admite conexión a hasta 5 redes DMR al mismo tiempo. Las reglas de reescritura asignan los talkgroups (llamadas de grupo) y las llamadas privadas a un solo rango de talkgroups, de modo que todas estas redes aparecen ante el radio cliente como una sola red.

La x del encabezado de la sección son los números del 1 al 5 o la palabra Custom. Fuera de esa etiqueta, cada sección es casi idéntica, así que abajo se describe una sola vez, señalando las diferencias.

*Tabla: [DMR Network x]*¶
Opción	Predeterminado	Descripción
Tabla: [XLX Network]	`0`	Activa la conexión a esta red DMR.
Address=`<master DMR>`	`None`	El nombre DNS del master DMR.
Port=`<puerto entero>`	`0`	El puerto del master DMR de destino para la conexión.
Rewrite Rules		Aquí van las reglas de reescritura que modifican los talkgroups y las llamadas privadas conforme pasan por DMRGateway. Son complejas y se tratan en un capítulo aparte, Reglas de reescritura de DMRGateway.
Password=`<cadena>`	`"passw0rd"`	Contraseña necesaria para acceder al master DMR remoto.
Id=`<DMR ID>`	`0`	Con qué DMR ID quieres presentar este gateway ante la red DMR remota. Un `0` toma este DMR ID de MMDVMHost.
WPSD_AutoRewrites=`[0\	`1`	Interruptor de las reglas de reescritura automáticas de la red DMR personalizada. Si lo desactivas (`0`), WPSD no ajustará automáticamente las reglas de reescritura de la red DMR personalizada según los prefijos de red. Esto es para que puedas configurarlas a mano en el archivo de configuración de mmdvmhost sin que la configuración web las sobrescriba. Esto solo aplica a la red DMR personalizada (Custom).
Debug=`[0\	`0`	Activa registro adicional.
Location=`[0\	`1`	Activa el envío del campo de ubicación del hotspot al master DMR mediante el protocolo MMDVM. Algunas redes DMR pueden usarlo para actualizar una ubicación APRS; otras no. Esto es completamente independiente de cualquier ubicación basada en el radio que proporcionen los radios cliente.
Name=`<cadena>`	`None`	Un nombre legible para esta red DMR, que se muestra en los registros y en el dashboard.
Options=`<cadena entre comillas>`	`None`	Una línea de opciones que se envía al master DMR. Depende de la red DMR a la que te conectes, así que consulta con ellos para configurarla correctamente.
Local=`<puerto entero>`	`0`	Define el puerto local que se usará para las conexiones salientes. `0` significa un puerto aleatorio.

[GPSD]¶

Esta sección configura DMRGateway para obtener la ubicación del equipo donde corre DMRGateway mediante una conexión de red a un servidor GPSD. Esa ubicación se usará entonces en lugar de la latitud y longitud indicadas en la sección [INFO].

[GPSD]¶
Opción	Predeterminado	Descripción
Tabla: [GPSD]	`0`	Activa la consulta a un servidor GPSD para obtener la ubicación.
Address=`<dirección IP>`	`None`	La dirección IP del servidor GPSD.
Port=`<puerto entero>`	`None`	En qué puerto escucha el servidor GPSD. Normalmente es `2947`.

[APRS]¶

Esta sección configura DMRGateway para enviar actualizaciones de posición y estado APRS al servidor APRS-IS indicado.

[APRS]¶
Opción	Predeterminado	Descripción
Tabla: [GPSD]	`0`	Activa las actualizaciones de estado APRS.
Address=`<dirección IP>`	`None`	Dirección IP del servidor APRS-IS.
Port=`<puerto entero>`	`None`	Puerto del servidor APRS-IS.
Suffix=`<cadena>`	`-`	Una cadena corta con el sufijo del indicativo. Originalmente era el SSID del paquete AX.25 y por eso se limitaba a los números 0-15, pero esa limitación de AX.25 no aplica aquí. Puedes usar cualquier cadena sencilla, pero esta cadena, tu indicativo y un guion `-` deben sumar 9 caracteres o menos. Para una estación DMR, lo típico sería `D`. Consulta la especificación de SSID de APRS.
Description=`<cadena>`	`None`	Una descripción corta de texto que se envía a APRS.
Symbol=`"<cadena>"`	`None`	El símbolo APRS que se muestra para tu estación. Es un tema complejo, documentado en la página de símbolos APRS. WPSD usa `"Wi"` de forma predeterminada.

[Dynamic TG Control]¶

Esta sección configura un puerto UDP para recibir mensajes de control con los que se administran las reescrituras de talkgroups dinámicos.

[Dynamic TG Control]¶
Opción	Predeterminado	Descripción
Tabla: [XLX Network]	`0`	Tabla: [Dynamic TG Control]
Port=`<puerto entero>`	`3769`	Puerto UDP para recibir mensajes de control.

[Remote Control]¶

Esta sección configura un puerto UDP para recibir mensajes de control que ofrecen algunas capacidades de control remoto de DMRGateway.

[Remote Control]¶
Opción	Predeterminado	Descripción
Tabla: [GPSD]	`0`	Activa la función de control remoto.
Port=`<puerto entero>`	`0`	Puerto UDP en el que escuchar.
Address=`<dirección IP>`	`127.0.0.1`	Dirección IP a la que se asocia el socket UDP.

Archivo de configuración de DMRGateway¶

Secciones de DMRGateway¶

[General]¶

[Log]¶

[Voice]¶

[Info]¶

[XLX Network]¶

[DMR Network x]¶

[GPSD]¶

[APRS]¶

[Dynamic TG Control]¶

[Remote Control]¶

[DMR Network `x`]¶