Najczęściej zadawane
pytania (FAQ).

Tak. CyfrowyStrażak działa na Windows 10/11 (x86_64), Ubuntu 20.04+, macOS 12+ oraz Raspberry Pi OS. Na Windows wymagany jest Python 3.9+ ze środowiska python.org oraz sterownik PortAudio dla PyAudio (instalowany automatycznie przez skrypt setup.bat). Interfejs dekodowania jest identyczny na wszystkich platformach.

Aktualizacje są wysyłane automatycznie e-mailem na adres przypisany do licencji. Dekoder sprawdza dostępność nowej wersji przy każdym uruchomieniu i informuje o możliwości pobrania. W przyszłości planujemy auto-update przez skrypt aktualizacyjny dla systemu Linux/RPi.

Nie jest wymagana zaawansowana wiedza techniczna. Skrypt instalacyjny automatyzuje cały proces konfiguracji środowiska. Dołączona instrukcja PDF zawiera zrzuty ekranu każdego kroku. W razie problemów możesz skontaktować się z pomocą techniczną przez Telegram lub e-mail.

Kody STQC edytuje się w pliku units_db.json w katalogu instalacyjnym. Plik ma prostą strukturę: powiat → jednostka → kod. Możesz edytować go w dowolnym edytorze tekstowym (np. Notepad++, nano) lub zaimportować z arkusza XLSX przez załączony skrypt import_units.py. Zmiany wchodzą w życie bez restartu dekodera (hot-reload).

Dekoder posiada wbudowany tryb kalibracji uruchamiany opcją --calibrate. System przez 30 sekund nasłuchuje szumu tła i automatycznie ustawia progi squelch, poziom AGC i agresywność filtra szumu. Parametry można też dostosować ręcznie w pliku config.json: próg_squelch, agc_speed, noise_reduction_strength (1.0–3.0).

W aktualnej wersji (1.x) dekoder obsługuje jedno wejście audio i jedną częstotliwość w trybie monitorowania. Obsługa wielu wejść równoległych (multi-channel) zaplanowana jest w wersji 2.0. Jako obejście można uruchomić wiele instancji dekodera z osobnymi kartami dźwiękowymi USB (obsługiwane).

Optymalny poziom sygnału wejściowego to -12 do -6 dBFS (widoczne na pasku VU w interfejsie). Moduł AGC automatycznie wyrównuje poziom, jednak sygnał zbyt cichy (<-30 dBFS) lub przesterowany (clipping) może pogorszyć dokładność detekcji. Zalecamy ustawienie głośności wyjścia radia na ok. 50–60% i dostrojenie przez pokrętło "Line In" w systemie.

Dołączony plik strazak.service to gotowa jednostka systemd. Skopiuj ją do /etc/systemd/system/ i wykonaj systemctl enable strazak && systemctl start strazak. Dekoder będzie uruchamiany automatycznie po restarcie RPi i restartowany w razie awarii (RestartOnFailure).

Po wpisaniu adresu e-mail na stronie głównej otrzymasz e-mail z danymi dostępowymi (login + hasło tymczasowe) i pełną licencją Pro na 7 dni. Nie jest wymagana karta kredytowa. Po upływie okresu próbnego dekoder przejdzie w tryb demo (ograniczone funkcje AI) – możesz wtedy wykupić subskrypcję przez stronę buy.php.

Plan Standard i Pro obejmuje licencję na 1 instalację (1 urządzenie). Plan Gmina/Związek umożliwia instalację na 5+ urządzeniach z jedną licencją główną i indywidualną konfiguracją zdalną dla każdej jednostki. W przypadku potrzeby instalacji na większej liczbie urządzeń skontaktuj się w celu wyceny.

Tak. Upgrade (np. Standard → Pro) jest dostępny w dowolnym momencie – zostaniesz obciążony różnicą cen proporcjonalnie do pozostałego okresu. Downgrade możliwy jest z końcem bieżącego okresu rozliczeniowego. Zmiany planów realizowane są przez kontakt na kontakt@cyfrowystrazak.pl.

Faktury VAT wystawiane są automatycznie na adres e-mail po każdej płatności. Na życzenie wystawiamy fakturę na dane firmy lub jednostki OSP (podaj NIP przy zakupie). Plan Gmina/Związek oferuje fakturę z odroczonym terminem płatności (do 30 dni) – skontaktuj się przed zakupem.

Dekoder przechodzi w tryb ograniczony: wyłącza funkcje AI (Neural Reconstruction, Smart Squelch AI), powiadomienia Telegram/FCM oraz eksport CSV. Podstawowe dekodowanie STQC z FFT i filtrem Butterwortha pozostaje aktywne przez 7 dni po wygaśnięciu, aby umożliwić odnowienie licencji bez przerwy w działaniu.

Utwórz bota przez @BotFather na Telegramie (komenda /newbot) i skopiuj otrzymany token API. W pliku config.json wpisz token w polu telegram_token oraz ID grupy lub kanału w polu telegram_chat_id. ID grupy pobierzesz przez @userinfobot. Możesz dodać wiele grup/kanałów jako tablicę JSON.

To zależy od ustawień powiadomień w aplikacji Telegram. Zalecamy skonfigurowanie bota w dedykowanej grupie strażackiej i ustawienie w Telegramie wyjątku "Bez wyciszenia" dla tej grupy. Alternatywnie, powiadomienia FCM (plan Pro) mogą wybudzić urządzenie Android/iOS z pominięciem trybu cichego dzięki konfiguracji jako "alarm sound".

W pliku config.json ustaw webhook_url na adres swojego serwera. Dekoder wyśle żądanie HTTP POST z JSON zawierającym: event_id, timestamp, stqc_code, unit_name, district, confidence, signal_strength. Opcjonalnie ustaw webhook_secret – payload zostanie podpisany nagłówkiem HMAC-SHA256.

Sprawdź kolejno: (1) czy token bota jest poprawny i bot jest dodany do grupy jako admin, (2) czy chat_id jest poprawny (wartość ujemna dla grup), (3) logi dekodera (log/dispatcher.log) w poszukiwaniu błędów HTTP. Najczęstsze problemy: bot nie dodany do grupy, błędny chat_id, blokada wyjścia na port 443 przez firewall RPi.

Potrzebujesz kabla audio 3.5mm jack (stereo lub mono) od wyjścia głośnikowego lub LINE OUT radia do wejścia karty dźwiękowej USB podłączonej do RPi. Raspberry Pi nie posiada wejścia audio – wymagana jest dodatkowa karta dźwiękowa USB (np. Sabrent USB-SBCV, ~30 zł). Połącz wyjście "SPKR" radia z "LINE IN" karty przez rezystor 1kΩ (opcjonalny, chroni wejście).

Tak. Do pracy z RTL-SDR potrzebujesz oprogramowania wirtualnej karty dźwiękowej (np. VB-Audio Virtual Cable na Windows lub darkice na Linux), które przekazuje audio z SDR# / GQRX na wirtualne wejście audio dekodera. Alternatywnie możesz użyć trybu direct-pipe przez nasz skrypt rtlsdr_pipe.sh (dostępny w wersji Pro).

Raspberry Pi Zero (v1 i W) ma zbyt słaby procesor (700 MHz, 512 MB RAM) dla modułów AI działających w czasie rzeczywistym. Minimalne zalecane to RPi 3B+ (1.4 GHz, 1 GB RAM). RPi Zero można użyć w trybie "Legacy" bez modułów AI (tylko FFT + Butterworth) – tę konfigurację uruchomisz opcją --no-ai.

Raspberry Pi 4B z uruchomionym dekoderem pobiera ok. 3–4W (zależnie od obciążenia AI). Przy zasilaniu przez UPS (np. PiJuice) lub zasilacz awaryjny 5V/3A możliwa jest praca bateryjno-sieciowa. Zalecamy zasilacz 5V/3A USB-C dla stabilności napięcia pod obciążeniem karty dźwiękowej USB.

Fałszywe alarmy mogą wystąpić przy: (1) zbyt niskim progu squelch – podwyższ wartość w config.json, (2) złym połączeniu audio z hałaśliwą kartą – wymień na kartę USB, (3) silnych zakłóceniach RF w terenie – zwiększ agresywność filtra szumu (noise_reduction_strength=2.0). Moduł Smart Squelch AI (plan Pro) redukuje fałszywe alarmy do <0.01%.

Standard STQC zakłada parę tonów o długości 1,0–1,5 s każdy. Dekoder wymaga wykrycia minimum 3 kolejnych ramek FFT (ok. 70 ms) przekraczających próg amplitudy dla każdego tonu. Moduł Neural Reconstruction może odtworzyć sekwencję z zaledwie 40% kompletności, co odpowiada ok. 0.4 s każdego tonu.

Aktualnie dekoder obsługuje system STQC stosowany przez PSP/OSP w Polsce (2-tonowy). System 5-Tone (EEA/CCIR/ZVEI) stosowany w zachodnich krajach jest planowany w wersji 2.0 jako opcjonalny moduł. Skontaktuj się, jeśli Twoja jednostka korzysta z 5-Tone – możemy udostępnić beta-wersję modułu.

Dziennik zdarzeń zapisywany jest automatycznie w pliku logs/events.csv (separator: średnik, kodowanie UTF-8). Plik można otworzyć bezpośrednio w Excelu (Dane → Z tekstu/CSV). W przyszłości planowany jest panel webowy z możliwością filtrowania i eksportu z poziomu przeglądarki.

Nie. Dekoder CyfrowyStrażak działa w całości lokalnie na Twoim urządzeniu (Raspberry Pi lub PC). Żadne dane audio, kody STQC ani zdarzenia nie są wysyłane na nasze serwery. Jedyna komunikacja z zewnętrzem to: sprawdzanie aktualizacji przy starcie (opcjonalne, można wyłączyć) oraz powiadomienia Telegram/FCM przez Twój własny token.