Hamradio/darthvader/pl

Poradnik dla początkujących: jak zainstalować i uruchomić darthvader — program na komputer, który skupia każdą krótkofalarską sieć głosu cyfrowego (DMR, YSF, D-STAR, NXDN, P25, M17, EchoLink, AllStar, SvxLink, APRS, POCSAG) w jednym oknie, na Windows lub Linux. Pobierz, zainstaluj, gotowe.

💡 W jednym zdaniu: darthvader to aplikacja desktopowa na twój komputer, która łączy się z sieciami głosu cyfrowego, dla których inaczej potrzebowałbyś hotspota lub kilku programów. Vocoder AMBE może być pendrivem USB (DV3000/ThumbDV), zdalnym AMBEserverem albo programowy (bez dodatkowego sprzętu).

Czy tego potrzebuję?

• Chcesz pracować głosem cyfrowym z komputera — nadawać i słuchać na DMR / YSF / D-STAR / NXDN / P25 / M17, łączyć przez EchoLink / AllStar / SvxLink, lub wysyłać wiadomości APRS / pager (POCSAG) — bez budowania osobnego hotspota dla każdego.
• Działa na zwykłym komputerze z Windows 10/11 lub maszynie Linux (Debian/Ubuntu/Raspberry Pi OS).
• Nie musisz wcześniej instalować Qt, kodeków ani niczego innego — wszystko jest w pakiecie.

Jedyne, co możesz dodać, to vocoder AMBE dla trybów, które go wymagają (zobacz niżej) — ale jest opcja programowa, więc możesz zacząć bez niczego dodatkowego.

Jak go zdobyć

Wszystko publikowane jest na stronie wydań:

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

Pobierz plik dla swojego systemu, a potem postępuj zgodnie z odpowiednią sekcją poniżej.

Instalacja — Windows 10 / 11

1. Pobierz darthvader-<version>-win64.msi.
2. Kliknij dwukrotnie i przejdź przez instalator — otrzymasz skrót w menu Start i na pulpicie.
3. Przy pierwszym uruchomieniu Windows SmartScreen może pokazać niebieskie ostrzeżenie (kompilacja nie jest podpisana). Kliknij „Więcej informacji” → „Uruchom mimo to”.

⚠ To nie wirus. Niepodpisane aplikacje zawsze wywołują SmartScreen, a kilka silników antywirusowych oznacza nieznane programy tylko z powodu reputacji. Dla pewności zweryfikuj pobrany plik względem opublikowanego SHA256SUMS (zobacz niżej).

Wolisz bez instalatora? Pobierz …-win64.zip, rozpakuj gdziekolwiek i uruchom bin\darthvader.exe — w pełni przenośne, nic nie jest zapisywane w systemie.

Wdrożenie na wiele komputerów (instalacja cicha):

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

Instalacja — Debian / Ubuntu / Raspberry Pi

Opcja A — po prostu zainstaluj ten jeden plik:

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

apt sam pobierze wszystkie zależności.

Opcja B — dodaj repozytorium apt raz, potem aktualizuj zwykłym apt:

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

💡 Obecnie pakiet Linux jest budowany dla Debian 13 (trixie), x86-64. bookworm i arm64 (Raspberry Pi) są planowane — jeśli nie ma jeszcze pakietu dla twojego Pi, użyj na razie komputera Windows lub Linux x86-64.

Zweryfikuj pobrany plik

Każde wydanie zawiera plik SHA256SUMS. Aby sprawdzić, że plik jest nienaruszony i oryginalny:

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

Wyświetlony skrót musi zgadzać się z linią w SHA256SUMS.

Wybór vocodera

Kilka trybów cyfrowych używa kodeka głosu AMBE+2. darthvader daje trzy sposoby jego zapewnienia — wybierz jeden:

Vocoder	Czego potrzebujesz	Uwagi
DV3000 / ThumbDV / DVstick (pendrive USB)	włóż go do portu USB	Pojawia się jako port szeregowy/COM (FTDI) i jest wykrywany automatycznie. Najlepsza jakość, najtańsza droga sprzętowa.
Zdalny AMBEserver	dostępny AMBEserver w sieci (UDP)	Użyj współdzielonego/zdalnego dongla — bez lokalnego sprzętu.
Vocoder programowy	nic dodatkowego	Działa bez układu. P25 ma pełny programowy IMBE; inne tryby mogą użyć programowego vocodera firmware MD380 (zobacz notkę poniżej).

⚠ Programowy vocoder firmware MD380 wymaga plików md380fw.img / md380ram.img w share/darthvader/vocoder_fw. To firmware Tytery i nie jest dołączone do darthvader — dostarczasz je sam. Pendrive DV3000 lub zdalny AMBEserver tego nie potrzebują.

Pierwsze uruchomienie

💡 Pełnego przewodnika po pierwszym uruchomieniu nie ma jeszcze w pakiecie. Ogólnie: otwórz Ustawienia, dodaj konto/serwer dla każdego używanego trybu (master DMR jak BrandMeister/TGIF, reflektor D-STAR/YSF/NXDN/P25/M17, EchoLink, węzły AllStar, reflektory SvxLink, APRS/DAPNET), wybierz vocoder, ustaw urządzenia audio i połącz się. Pasek stanu pokazuje kolorową kropkę na tryb, a pasek tytułu / Informacje pokazuje dokładną kompilację.

Szczegóły zależne od trybu (talkgrupy, nazwy reflektorów, uprawnienia) znajdziesz w dokumentacji danej sieci — zobacz Hamradio.

Audio

darthvader ma tor audio na kierunek — przedwzmacniacz → 7-pasmowy EQ → LADSPA → AGC → limiter — konfigurowalny na tryb/peera, z dołączonymi wtyczkami LADSPA, więc tor ustawiony na Linuksie działa identycznie na Windows. Zacznij od wartości domyślnych; ruszaj je tylko, gdy inni zgłaszają, że twoje audio jest za ciche, za głośne lub nierówne.

Rozwiązywanie problemów

Objaw	Rozwiązanie
Ostrzeżenie SmartScreen / antywirusa Windows przy pierwszym uruchomieniu	Normalne dla niepodpisanej aplikacji → „Więcej informacji” → „Uruchom mimo to”. W razie wątpliwości zweryfikuj przez SHA256SUMS.
Audio DV3000 przerywa	Zmniejsz Latency Timer pendrive'a do 1–2 ms (Windows: Menedżer urządzeń → port COM → Ustawienia portu → Zaawansowane).
Vocoder programowy nie startuje	Brak plików firmware MD380 — dodaj md380fw.img/md380ram.img, albo użyj pendrive'a DV3000 / AMBEserwera.
Brak .deb dla mojego Raspberry Pi	Kompilacje arm64 „wkrótce” — jeszcze niedostępne. Użyj na razie Linuksa x86-64 lub Windows.

Aktualizacja

• Windows: pobierz nowszą .msi i zainstaluj na wierzchu (lub podmień folder przenośny).
• Linux (repo apt): sudo apt update && sudo apt upgrade.
• Linux (pojedynczy .deb): pobierz nowy .deb i ponownie sudo apt install ./….

Wersja jest pokazana jako <numer>-<git-hash> na pasku tytułu i w oknie Informacje.

Zobacz też

• Hamradio — tryby głosu cyfrowego, którymi mówi darthvader, każdy szczegółowo.
• Autor: SA7AUX <bjorne@sa7aux.se>. GNU GPL v2 lub nowsza.