🛰️ Guida Completa all’Installazione di un Server DVSwitch su Debian

Il pacchetto DVSwitch è un insieme di strumenti sviluppati per permettere ai radioamatori di gestire in modo flessibile le comunicazioni digitali (DMR, D-STAR, YSF, NXDN, P25, M17) utilizzando un semplice computer Linux.
Può essere installato su un server Debian, un mini-PC o un Raspberry Pi, ed è perfetto per chi vuole creare un hotspot digitale personale o condiviso.

📦 1. Requisiti di sistema

Hardware consigliato

CPU: dual-core o superiore (ARM o x86)
RAM: minimo 1 GB (2 GB consigliati)
Storage: 8 GB liberi
Rete: connessione Internet stabile

Software

Debian 11 “Bullseye” o Debian 12 “Bookworm”
Accesso root o con privilegi sudo

🧰 2. Aggiornamento del sistema

Prima di iniziare, aggiorna la tua installazione Debian:

sudo apt update && sudo apt upgrade -y
sudo apt install git wget curl -y

⚙️ 3. Installazione dei pacchetti DVSwitch

DVSwitch è composto da diversi moduli:

Analog_Bridge – converte l’audio analogico in digitale;
DMRlink / MMDVM_Bridge – connessione alle reti digitali (es. BrandMeister, TGIF, FreeDMR);
DVSwitch Server – gestisce la comunicazione tra client (Mobile, Dashboard, ecc.).

Per installare i pacchetti principali:

cd /opt
sudo git clone https://github.com/DVSwitch/DVSwitch.git
cd DVSwitch
sudo ./install.sh

Durante l’installazione ti verrà chiesto di:

selezionare i moduli da installare;
impostare le porte e i servizi (puoi accettare i valori predefiniti).

🧩 4. Configurazione iniziale

Dopo l’installazione, i file di configurazione si trovano di solito in:

/opt/DVSwitch/etc/

File principali

Analog_Bridge.ini
MMDVM_Bridge.ini
DMRlink.ini
DVSwitch.ini

Apri e modifica i file con un editor, ad esempio:

sudo nano /opt/DVSwitch/etc/Analog_Bridge.ini

🆔 5. Configurare il tuo ID DMR

Ogni radioamatore deve utilizzare il proprio ID DMR registrato.
Puoi ottenerlo su https://register.ham-digital.org.

Nel file MMDVM_Bridge.ini, cerca la sezione [General] e imposta:

Callsign = IU2XXX
Id = 222XXXX
Timeout = 180
Duplex = 0

🌐 6. Collegamento alla rete DMR

Apri il file /opt/DVSwitch/etc/DMRlink.ini e configura i parametri della rete (es. BrandMeister):

[DMR Network]
Enabled=1
Name=BrandMeister
Address=2221.master.brandmeister.network
Port=62031
Password=passw0rd
Local=62032
TGRewrite0=1,9,1,9,999999
PCRewrite0=1,9,1,9,999999
Id=222XXXX
Location=0

Salva e riavvia i servizi:

sudo systemctl restart analog_bridge
sudo systemctl restart dmr_link

🎛️ 7. Configurare il Bridge Audio

Il file Analog_Bridge.ini gestisce il flusso audio tra DVSwitch e i client (Mobile o Radio).

Esempio base:

[General]
LogFilePath=/var/log/Analog_Bridge
Daemon=1
[USRP]
Address=127.0.0.1
Port=32001
LocalPort=32002
Jitter=300
GainAdjust=0.0

📲 8. Collegare il client (DVSwitch Mobile o Dashboard)

Puoi utilizzare:

DVSwitch Mobile (app Android)
DVLink (client desktop)
Pi-Star o OpenSpot come ponte esterno.

Imposta nel client:

IP del server Debian
Porta UDP (default 32001)
Password e nominativo configurati in DVSwitch.ini.

🔐 9. Sicurezza e manutenzione

Cambia la password predefinita nel file DVSwitch.ini.
Attiva il firewall per limitare gli accessi: sudo ufw allow 22,32001,62031/tcp sudo ufw enable
Aggiorna periodicamente: cd /opt/DVSwitch git pull sudo ./update.sh

🧭 10. Test del server

Per verificare che tutto funzioni:

sudo systemctl status analog_bridge
sudo systemctl status dmr_link

Se entrambi risultano active (running), puoi tentare la connessione dal tuo client mobile o software.

Puoi anche monitorare i log in tempo reale:

tail -f /var/log/Analog_Bridge/Analog_Bridge.log

🚀 Conclusione

Con pochi passaggi hai creato il tuo server DVSwitch su Debian, pronto per collegarsi alle principali reti digitali DMR e multimodo.
È una soluzione ideale per radioamatori che desiderano:

avere un hotspot personale senza hardware dedicato;
sperimentare i modi digitali (DMR, YSF, D-STAR, NXDN, M17);
gestire il proprio nodo da remoto via Internet.

GUIDA INSTALLAZIONE DV-SWITCH