Hamradio/darthvader/it

Una guida per principianti per installare e usare darthvader — un programma desktop che riunisce ogni rete di voce digitale radioamatoriale (DMR, YSF, D-STAR, NXDN, P25, M17, EchoLink, AllStar, SvxLink, APRS, POCSAG) in un'unica finestra, su Windows o Linux. Scarica, installa, via.

💡 In una frase: darthvader è unapp desktop per il tuo PC che si collega alle reti di voce digitale per cui altrimenti servirebbe un hotspot o più programmi. Il vocoder AMBE può essere una chiavetta USB (DV3000/ThumbDV), un AMBEserver remoto o software (nessun hardware aggiuntivo).

Mi serve?

• Vuoi operare in voce digitale dal computer — trasmettere e ascoltare su DMR / YSF / D-STAR / NXDN / P25 / M17, collegarti via EchoLink / AllStar / SvxLink, o inviare messaggi APRS / cercapersone (POCSAG) — senza costruire un hotspot separato per ciascuno.
• Gira su un normale PC Windows 10/11 o una macchina Linux (Debian/Ubuntu/Raspberry Pi OS).
• Non devi installare prima Qt, codec o altro — tutto è incluso nel pacchetto.

L'unica cosa che potresti aggiungere è un vocoder AMBE per i modi che lo richiedono (vedi sotto) — ma c'è un'opzione software, quindi puoi partire senza nulla in più.

Ottenerlo

Tutto è pubblicato nella pagina delle release:

• https://git.sa7aux.se/bjorne/darthvader-dist/releases

Scarica il file per il tuo sistema e segui la sezione corrispondente qui sotto.

Installazione — Windows 10 / 11

1. Scarica darthvader-<version>-win64.msi.
2. Doppio clic e segui l'installer — ottieni un collegamento nel menu Start e sul desktop.
3. La prima volta che lo avvii, Windows SmartScreen può mostrare un avviso blu (la build non è firmata). Clicca «Ulteriori informazioni» → «Esegui comunque».

⚠ Non è un virus. Le app non firmate attivano sempre SmartScreen, e alcuni antivirus segnalano i programmi sconosciuti solo per reputazione. Per sicurezza, verifica il download con il SHA256SUMS pubblicato (vedi sotto).

Preferisci senza installer? Scarica il …-win64.zip, decomprimilo ovunque ed esegui bin\darthvader.exe — completamente portatile, nulla viene scritto nel sistema.

Distribuzione su molti PC (installazione silenziosa):

msiexec /i darthvader-<version>-win64.msi /qn

Installazione — Debian / Ubuntu / Raspberry Pi

Opzione A — installa solo il file:

sudo apt install ./darthvader_<version>_amd64.deb

apt risolve automaticamente le dipendenze.

Opzione B — aggiungi il repo apt una volta, poi aggiorna col normale apt:

curl -fsSL https://debrepo.sa7aux.se/setup.sh | sudo bash
sudo apt install darthvader

💡 Oggi il pacchetto Linux è compilato per Debian 13 (trixie), x86-64. bookworm e arm64 (Raspberry Pi) sono in programma — se non c'è ancora un pacchetto per il tuo Pi, usa per ora un PC Windows o Linux x86-64.

Verifica il download

Ogni release include un file SHA256SUMS. Per controllare che un download sia integro e autentico:

sha256sum -c SHA256SUMS      # Linux/macOS
# Windows (PowerShell):  Get-FileHash .\darthvader-<version>-win64.msi -Algorithm SHA256

L'hash stampato deve coincidere con la riga in SHA256SUMS.

Scegliere un vocoder

Diversi modi digitali usano il codec vocale AMBE+2. darthvader ti dà tre modi per fornirlo — scegline uno:

Vocoder	Cosa serve	Note
DV3000 / ThumbDV / DVstick (chiavetta USB)	inseriscila in una porta USB	Appare come porta seriale/COM (FTDI) e viene rilevata da sola. Migliore qualità, la via hardware più economica.
AMBEserver remoto	un AMBEserver raggiungibile via rete (UDP)	Usa un dongle condiviso/remoto — nessun hardware locale.
Vocoder software	niente in più	Funziona senza chip. P25 ha un IMBE software completo; altri modi possono usare il vocoder software del firmware MD380 (vedi la nota sotto).

⚠ Il vocoder software del firmware MD380 richiede i file md380fw.img / md380ram.img in share/darthvader/vocoder_fw. È firmware di Tytera e non è incluso in darthvader — lo fornisci tu. Una chiavetta DV3000 o un AMBEserver remoto non ne hanno bisogno.

Primo avvio

💡 Una guida completa al primo avvio non è ancora nel pacchetto di download. In generale: apri Impostazioni, aggiungi il tuo account/server per ogni modo che usi (master DMR come BrandMeister/TGIF, un reflector D-STAR/YSF/NXDN/P25/M17, EchoLink, nodi AllStar, reflector SvxLink, APRS/DAPNET), scegli il tuo vocoder, imposta i tuoi dispositivi audio e connettiti. La barra di stato mostra un pallino colorato per modo, e la barra del titolo / Informazioni mostra la build esatta.

Per i dettagli per modo (talkgroup, nomi dei reflector, permessi) segui la documentazione propria di ciascuna rete — vedi Hamradio.

Audio

darthvader ha una catena audio per direzione — preamplificatore → EQ a 7 bande → LADSPA → AGC → limiter — configurabile per modo/peer, con plugin LADSPA inclusi, così una catena impostata su Linux funziona identica su Windows. Parti dai valori predefiniti; toccali solo se altri segnalano che il tuo audio è troppo basso, troppo alto o irregolare.

Risoluzione dei problemi

Sintomo	Soluzione
Avviso di SmartScreen / antivirus di Windows al primo avvio	Normale per un'app non firmata → «Ulteriori informazioni» → «Esegui comunque». Verifica con SHA256SUMS se hai dubbi.
L'audio del DV3000 è a scatti	Abbassa il Latency Timer della chiavetta a 1–2 ms (Windows: Gestione dispositivi → la porta COM → Impostazioni porta → Avanzate).
Il vocoder software non parte	Mancano i file del firmware MD380 — aggiungi md380fw.img/md380ram.img, oppure usa una chiavetta DV3000 / AMBEserver.
Nessun .deb per il mio Raspberry Pi	Le build arm64 arriveranno — non ancora disponibili. Usa per ora Linux x86-64 o Windows.

Aggiornare

• Windows: scarica la .msi più recente e installa sopra (o sostituisci la cartella portatile).
• Linux (repo apt): sudo apt update && sudo apt upgrade.
• Linux (singolo .deb): scarica il nuovo .deb e rifai sudo apt install ./….

La versione è mostrata come <numero>-<git-hash> nella barra del titolo e nella finestra Informazioni.

Vedi anche

• Hamradio — i modi di voce digitale che darthvader parla, ciascuno in dettaglio.
• Autore: SA7AUX <bjorne@sa7aux.se>. GNU GPL v2 o successiva.