168 lines
5.8 KiB
Markdown
168 lines
5.8 KiB
Markdown
# SIP-DMR Radio Gateway
|
|
|
|
Un gateway bidirezionale scritto in Python che permette di collegare centralini VoIP SIP (come FreePBX) a reti radio DMR (tramite protocollo OpenBridge).
|
|
|
|
Il sistema gestisce l'handshake SIP, la transcodifica audio in tempo reale tra PCM (G.711a) e AMBE, il controllo PTT tramite toni DTMF e il cambio dinamico del Talkgroup direttamente dal tastierino del telefono, simulando il comportamento di una vera radio.
|
|
|
|
## 🚀 Caratteristiche Principali
|
|
|
|
* **Integrazione Trasparente:** Dialoga nativamente con FreePBX gestendo i ping `OPTIONS` (Trunk PJSIP).
|
|
* **Cambio Canale al Volo:** Digita il numero del Talkgroup sul telefono e il gateway ti sposterà di stanza senza far cadere la chiamata.
|
|
* **Sicurezza IP:** Rifiuta nativamente le connessioni SIP da IP non autorizzati.
|
|
* **Aggiornamento Display:** Usa il protocollo `re-INVITE` per mostrare Caller ID (DMR ID) e Talkgroup attivi sui telefoni hardware compatibili.
|
|
* **Transcoding 100% Software:** Nessun hardware dedicato richiesto (es. DVStick). Il sistema usa l'emulatore nativo `md380-emu` elaborando l'audio crudo (RAW) direttamente tramite CPU.
|
|
* **Multi-Tenancy Dinamica:** Gestisce chiamate simultanee multiple. Il motore alloca e dealloca dinamicamente le porte UDP instradando gli stream audio in tempo reale sui vocoder liberi.
|
|
* **Audio Bidirezionale G.711 / AMBE:** Converte al volo i pacchetti SIP A-Law in PCM lineare 16-bit (tramite modulo `audioop`) per la rete DMR, e viceversa.
|
|
|
|
---
|
|
|
|
## 🛠️ 1. Prerequisiti di Sistema (Debian / Ubuntu)
|
|
|
|
Prima di installare il gateway, assicurati di avere gli strumenti di compilazione e l'ambiente Python installati sul server:
|
|
|
|
```bash
|
|
sudo apt update && sudo apt upgrade -y
|
|
sudo apt install -y git build-essential python3 python3-venv python3-pip
|
|
```
|
|
|
|
*(Nota: su architetture a 64-bit potrebbe essere necessario installare `libc6-dev-i386` per compilare correttamente l'emulatore AMBE).*
|
|
|
|
---
|
|
|
|
## 📻 2. Installazione Motore Audio Scalabile (md380-emu)
|
|
|
|
Il cuore della conversione audio è l'emulatore open-source `md380-emu`. Va scaricato, compilato e configurato come "template" Systemd per supportare un pool di porte.
|
|
|
|
```bash
|
|
cd /opt
|
|
sudo git clone https://github.com/nostar/md380-emu.git
|
|
cd md380-emu
|
|
sudo make
|
|
```
|
|
|
|
**Creazione del demone Systemd Template per le istanze multiple:**
|
|
|
|
Crea il file `/etc/systemd/system/md380-emu@.service`:
|
|
|
|
```ini
|
|
[Unit]
|
|
Description=MD380 Emulator Vocoder (Port %i)
|
|
After=network.target
|
|
|
|
[Service]
|
|
Type=simple
|
|
User=root
|
|
WorkingDirectory=/opt/md380-emu
|
|
# Il %i verrà sostituito automaticamente con il numero di porta
|
|
ExecStart=/opt/md380-emu/emulator -p %i
|
|
Restart=always
|
|
RestartSec=3
|
|
|
|
[Install]
|
|
WantedBy=multi-user.target
|
|
```
|
|
|
|
**Attivazione delle istanze (es. per 10 canali simultanei):**
|
|
|
|
Ricarica i demoni e avvia il loop di porte (es. dalla 2470 alla 2479):
|
|
|
|
```bash
|
|
sudo systemctl daemon-reload
|
|
for port in {2470..2479}; do
|
|
sudo systemctl enable --now md380-emu@$port.service
|
|
done
|
|
```
|
|
|
|
*(Per aumentare la capacità futura, ti basterà avviare nuovi servizi systemctl ed espandere il range di porte generate in `vocoder_engine.py`).*
|
|
|
|
---
|
|
|
|
## 💻 3. Installazione del Gateway Python
|
|
|
|
Clona questo repository e configura l'ambiente virtuale:
|
|
|
|
```bash
|
|
cd /opt
|
|
git clone https://git.arifvg.it/iv3jdv/sip-dmr-gateway.git
|
|
cd sip-dmr-gateway
|
|
|
|
# Crea e attiva il Virtual Environment
|
|
python3 -m venv venv
|
|
source venv/bin/activate
|
|
|
|
# Installa le dipendenze
|
|
pip install -r requirements.txt
|
|
```
|
|
|
|
Copia i file di esempio per creare la tua configurazione reale:
|
|
|
|
```bash
|
|
cp config.example.json config.json
|
|
cp utenti.example.json utenti.json
|
|
```
|
|
|
|
**Modifica `config.json`:** Inserisci le credenziali del tuo server HBlink/OpenBridge, le porte e, soprattutto, l'IP autorizzato del tuo server FreePBX per la sicurezza.
|
|
|
|
---
|
|
|
|
## ⚙️ 4. Configurazione FreePBX
|
|
|
|
Affinché il centralino dialoghi correttamente con il Gateway, crea un Trunk PJSIP con queste regole:
|
|
|
|
* **Autenticazione:** Nessuna (Identity via IP Match). L'IP match deve puntare all'IP del server dove gira questo script Python.
|
|
* **Qualify Frequency:** Lascialo attivo (es. 60 secondi). Il gateway risponderà regolarmente con `200 OK`.
|
|
* **Codecs:** Disabilita tutto e lascia spuntato **SOLO `alaw`** (G.711a).
|
|
* **Advanced -> DTMF Mode:** Imposta su `RFC4733`.
|
|
* **Advanced -> Trust RPID/PAI:** Imposta su `Yes`.
|
|
* **Advanced -> Send RPID/PAI:** Imposta su `Both`.
|
|
|
|
Crea poi una Rotta in Uscita (Outbound Route) che intercetti un prefisso a tua scelta (es. `99`) e che lo *strippi* (lo elimini), inviando al Trunk solo il numero del Talkgroup.
|
|
|
|
---
|
|
|
|
## 📞 5. Utilizzo e Comandi DTMF (Tastierino)
|
|
|
|
Chiama la rotta configurata su FreePBX seguita dal Talkgroup desiderato (es. componi `99 222` per entrare sul TG 222). Una volta in linea, usa il tastierino del telefono per pilotare la radio:
|
|
|
|
* **Tasto `*` (Asterisco):** Premi per abilitare il PTT e iniziare a trasmettere.
|
|
* **Tasto `#` (Cancelletto):** Premi per disabilitare il PTT e tornare in ascolto.
|
|
* **Tasti `0-9` (Cambio Canale):** Digita il numero di un nuovo Talkgroup (es. `9`, `1`) e rilascia i tasti. Dopo circa 2,5 secondi il sistema ti sposterà automaticamente sul nuovo TG (verrai avvisato da un aggiornamento sul display del telefono, se supportato).
|
|
|
|
---
|
|
|
|
## 🔄 6. Esecuzione come Servizio (Produzione)
|
|
|
|
Per far avviare il Gateway automaticamente al boot, crea il file `/etc/systemd/system/sipdmr.service`:
|
|
|
|
```ini
|
|
[Unit]
|
|
Description=Gateway SIP-DMR Core
|
|
After=network.target
|
|
|
|
[Service]
|
|
Type=simple
|
|
User=root
|
|
WorkingDirectory=/opt/sip-dmr-gateway
|
|
ExecStart=/opt/sip-dmr-gateway/venv/bin/python3 /opt/sip-dmr-gateway/core.py
|
|
Restart=always
|
|
RestartSec=5
|
|
StandardOutput=syslog
|
|
StandardError=syslog
|
|
SyslogIdentifier=sipdmr
|
|
|
|
[Install]
|
|
WantedBy=multi-user.target
|
|
```
|
|
|
|
Abilita e avvia il gateway:
|
|
|
|
```bash
|
|
sudo systemctl enable sipdmr --now
|
|
```
|
|
|
|
Per visualizzare i log in tempo reale e monitorare il traffico radio:
|
|
|
|
```bash
|
|
journalctl -u sipdmr -f
|
|
```
|