Otwarty ekosystem TETRA.

TetraSpot to implementacja stosu protokołów TETRA. Projekt umożliwia uruchomienie stacji bazowej TETRA z obsługą połączeń głosowych (grupowych, indywidualnych simplex i full-duplex), wiadomości SDS, lokalizacji GPS (LIP) oraz integracji z sieciami zewnętrznymi (TetraPack przez hub TetraPoland, SIP/PABX). Architektura oparta na mikroserwisach pozwala na elastyczne wdrożenie — od pojedynczego Raspberry Pi 5 po konfiguracje wielostanowiskowe.

Funkcjonalności

• Pełny stos radiowy BS: PHY → LMAC → UMAC → LLC → MLE → MM/CMCE/SNDCP
• Modulacja/demodulacja π/4-DQPSK (USRP, LimeSDR, LimeSDR Mini, sxceiver)
• Rozgłaszanie SYNC/SYSINFO — sieć widoczna jako prawidłowa sieć TETRA
• Rejestracja terminali (MM Location Update) i przyłączanie do grup
• Połączenia głosowe grupowe — własna implementacja kodeka ACELP wg specyfikacji ETSI
• Połączenia indywidualne P2P (half-duplex i full-duplex)
• Sterowanie podłogą (floor control) dla połączeń half-duplex
• Wiadomości SDS — indywidualne i grupowe, wysyłanie, odbieranie, store & forward
• Przekazywanie szyfrowanych rozmów prywatnych (E2EE) — hub przekazuje je, ale nie zna klucza
• Lokalizacja GPS/LIP — śledzenie pozycji terminali
• Opcjonalne uwierzytelnianie TEA1 z białą listą
• Dystrybucja kluczy OTAR (Over-The-Air Rekeying) — SCK/CCK/GCK
• Dynamiczne przypisywanie grup (DGNA)
• Logowanie do sieci danymi BrandMeister
• Integracja z TetraPack przez hub TetraPoland
• Hub TetraPoland: arbitraż podłogi, konta w panelu, log zdarzeń i podgląd na żywo
• Konsola administratora huba: rozmowa z poziomu przeglądarki, nasłuch wybranego źródła, nagrywanie połączeń
• Zdalne sterowanie stacją wiadomością SDS — status albo tekst, z potwierdzeniem doręczenia
• Bramka telefoniczna SIP/PABX
• Panel zarządzania WWW (dashboard, logi połączeń, konfiguracja)
• Baza DMR ID z wyszukiwaniem po znaku (callsign)
• Wdrożenie na Raspberry Pi 5 z usługami systemd

W rozwoju

Architektura

  BS #1 (RPi5)    BS #2 (RPi5)    BS #N
  ┌──────────┐    ┌──────────┐    ┌─────┐
  │ PHY/LMAC │    │ PHY/LMAC │    │ ... │
  │ UMAC/LLC │    │ UMAC/LLC │    │     │
  │ MLE      │    │ MLE      │    │     │
  └────┬─────┘    └────┬─────┘    └──┬──┘
       │               │             │
       └───────────────┼─────────────┘
                       │ QUIC (bitcode)
          ┌────────────┴────────────┐
          │   SWITCH (DXT) :4433   │
          │   MM / CMCE / SNDCP    │
          │   Service Registry     │
          └────────────┬────────────┘
                       │
  ┌─────────┬────────┬───┼───┬──────────┬───────────┐
  │         │        │       │          │           │
Audio GW   SDS    Auth     LIP    Telephony  Management
(ACELP,   Server Server  Server     GW        Panel
 Brew/RTP) (REST) (TEA1/   (GPS)  (SIP/PABX)  :8080
                  OTAR)

Topologia gwiazdy z centralnym Switch (DXT). Wszystkie mikroserwisy komunikują się przez QUIC z serializacją bitcode.

Jedno urządzenie zamiast kilku radiotelefonów — Multi-Radio pracuje dziś w sześciu systemach: analogowym FM, TETRA, DMR, P25, M17 i D-STAR. Całość mieści się na Raspberry Pi z jedną nakładką SDR. Pracujemy nad nim od marca 2026 i to pierwszy SDR-owy terminal o tak małych wymaganiach sprzętowych w świecie HAM radio: rejestruje się w sieci, uwierzytelnia, przyłącza do grup, nadaje i odbiera głos oraz wymienia wiadomości — bez firmowego radiotelefonu za kilka tysięcy złotych. Sterujesz nim z aplikacji na telefonie, z przeglądarki albo z dotykowego panelu przy stacji, a wszystkie dane do logowania — ISSI, MCC/MNC i grupy — wprowadzasz online. Żadnego kabla programującego, firmowego oprogramowania ani procedury tworzenia codeplugu.

Tryby pracy — działające dziś

• FM analogowy — odbiór i nadawanie, wąsko- i szerokopasmowo
• TETRA TMO — terminal zalogowany do sieci
• TETRA DMO — nasłuch pracy bezpośredniej na żywo
• DMR — głos w obie strony, potwierdzony w eterze z radiotelefonem
• P25 — głos w obie strony, odbiór sprawdzony na realnym ruchu z eteru
• M17 — głos w obie strony, potwierdzony w eterze między stacjami
• D-STAR — głos w obie strony, potwierdzony w eterze z radiotelefonem
• Przełączanie trybu jednym przyciskiem

Zastosowania

Co już działa w trybie TETRA

• Rejestracja w sieci i uwierzytelnianie TAA1
• Przyłączanie do grup rozmównych
• Połączenia grupowe i indywidualne — zestawianie i zwalnianie
• Odbiór głosu (własna implementacja kodeka ACELP)
• Wiadomości SDS — wysyłanie, odbieranie, potwierdzenia doręczenia
• Statusy oraz meldunki pozycji LIP
• Podgląd parametrów sieci i poziomu odbieranego sygnału
• Konfiguracja logowania online — bez kabla i codeplugu

Co już działa w trybach cyfrowych

• DMR: odbiór na żywo — kto nadaje, na jaką grupę, na jakiej częstotliwości
• DMR: nadawanie głosu przyciskiem PTT prosto w eter
• DMR: własne ID, grupa, Color Code i moc ustawiane z aplikacji
• P25: nadawanie i odbiór głosu z odczytem identyfikatora radia i grupy
• P25: własny NAC, grupa i identyfikator nadającego ustawiane z aplikacji
• M17: głos w obie strony ze znakiem wywoławczym w każdej ramce
• D-STAR: głos w obie strony, znak wywoławczy i krótkie wiadomości
• TETRA DMO: nasłuch — kto nadaje, do kogo i w jakiej sieci
• Opcjonalne szyfrowanie głosu w trybach cyfrowych
• S-metr i wskaźniki odbioru oraz nadawania w każdym trybie

Sterowanie — telefon, przeglądarka, panel

• Aplikacja na Androida — pełna obsługa radia z telefonu
• Bluetooth jako podstawowe połączenie, sieć jako zapasowe
• PTT, nasłuch i podgląd na żywo w każdym trybie
• Zmiana częstotliwości, grup i parametrów bez wchodzenia w konfigurację stacji
• Panel WWW nadal dostępny — te same funkcje z przeglądarki
• Dotykowy panel czołowy przy stacji — sterowanie bez telefonu i komputera
• Parowanie Bluetooth otwierane świadomie i na chwilę — z zewnątrz nikt nie przejmie nadawania

W rozwoju

Wymagania sprzętowe

Webowy analizator sieci TETRA na Raspberry Pi. Monitoring 64 kanałów w czasie rzeczywistym z odtwarzaniem głosu, nagrywaniem rozmów, analizą widma, dekodowaniem SDS i śledzeniem lokalizacji terminali — wszystko z przeglądarki.

Funkcje

Architektura

RTL-SDR USB Dongle
       |
  GNURadio 3.10
  (demodulacja TETRA + FFT)
       |
       +---> UDP:42001 ---------> tetra-rx (osmo-tetra)
       +---> TCP:42002 (FFT/ZMQ)        |
                                         +---> UDP:7379 (TETMON)
                                         +---> TCP:42003 (konstelacja)
                                                    |
                                              TLA Backend
                                              (serwer WWW)
                                              HTTP:8080
                                                    |
                                              Przeglądarka

Aplikacja Android łącząca się z hubem TetraPoland przez szybkie, odporne połączenie QUIC. Działa jak programowy terminal TETRA — użytkownik dostaje pełną funkcjonalność radiotelefonu (rozmowy grupowe i indywidualne, SDS, skanowanie talkgrup) na zwykłym telefonie z połączeniem komórkowym lub Wi-Fi. Kompatybilna z obsługą PTT przez przyciski sprzętowe, bezprzewodowe przyciski Bluetooth LE i headset (SCO). Rozmowy prywatne między użytkownikami są szyfrowane end-to-end z ochroną postkwantową, można zalogować się danymi sieci BrandMeister, a pozycja GPS trafia na mapę tetra-poland.pl.

Funkcje

• Połączenia grupowe PTT (RX/TX) z floor control
• Połączenia indywidualne (half/full-duplex)
• Rozmowy prywatne szyfrowane end-to-end (E2EE)
• Szyfrowanie postkwantowe — X25519 + ML-KEM-768, z 12-cyfrowym kodem weryfikacyjnym
• Logowanie danymi sieci BrandMeister
• Wiadomości SDS — indywidualne i grupowe, z raportami dostarczenia i szybkimi odpowiedziami
• Skanowanie talkgrup z hold, priorytetem i presetami DSP
• Raportowanie pozycji GPS na mapę tetra-poland.pl i zapis śladu do pliku GPX
• Bezprzewodowe przyciski PTT Bluetooth LE (PTT-Z01, AnyTone, HM-10)
• Sprzętowy PTT i headset Bluetooth SCO
• Własna implementacja kodeka ACELP wg specyfikacji ETSI
• Transport QUIC (Brew-over-QUIC) — szybkie wznawianie po zmianie sieci
• Wysokiej jakości audio (bufor jitter, AGC, redukcja szumów)
• Działa nieprzerwanie w tle
• Lista kontaktów i historia połączeń
• Uwierzytelnianie HTTP Digest + TLS

Plugin do aplikacji ATAK (Android Team Awareness Kit) integrujący taktyczną mapę z radiokomunikacją TETRA. Pozycje terminali (LIP) trafiają na mapę ATAK jako CoT (Cursor on Target), wiadomości SDS wyświetlają się jak komunikaty, a PTT pozwala nadawać bez opuszczania mapy. Łączność z radiem przez USB/Serial, Bluetooth SPP lub TCP/IP do bramki.

Funkcje

• SDS — krótkie wiadomości tekstowe (SDS-1 / SDS-2)
• LIP — automatyczne przesyłanie pozycji na mapę CoT
• Status messages — predefiniowane i własne
• PTT — przycisk nadawania z poziomu mapy taktycznej
• Połączenia grupowe i indywidualne
• Pozycje kolegów z zespołu widoczne na mapie ATAK
• Floating PTT overlay na mapie (przeciągalny)
• Wskaźniki RX / TX, sygnału i baterii radia
• Zmiana talkgrupy z klawiatury radia (+MCTGS)
• Połączenie: USB/Serial, Bluetooth SPP lub TCP gateway
• Okresowe raportowanie pozycji (30 s w ruchu / 15 min w spoczynku)
• Automatyczne wznawianie połączenia i praca w tle (foreground service)

Aplet JavaCard implementujący moduł tożsamości TETRA (TIM/TSIM) zgodnie z ETSI TS 100 812-2. Realizuje pełny ciąg uwierzytelniania TAA1 (HURDLE + TA11/TA12/TA21/TA22/TB4), zarządzanie kluczami OTAR (TA32/TA52/TA71/TA82/TA92) oraz strukturę plików DF_TETRA z wymaganymi EF (ITSI, SPN, forbidden networks, adresy SCK/CCK/GCK). Działa przez interfejs UICC/APDU — może zastąpić oryginalną kartę w dowolnym terminalu TETRA.

Funkcje

• Pełny TAA1 — HURDLE + TA11/TA12/TA21/TA22/TB4
• OTAR — TA32/TA52 (SCK), TA71 (GCK), TA82 (CCK), TA92 (MGCK)
• DF_TETRA z wymaganymi EF (EF_ITSI, EF_SPN, EF_FORBIDDEN itd.)
• Zarządzanie PIN1 / PIN2 / ADM / PUK
• Interfejs UICC / APDU — kompatybilny z terminalami TETRA
• Personalizacja (ITSI, klucz K, SPN, MCC/MNC, security class)
• Klasy bezpieczeństwa SC1 (clear) / SC2 (SCK) / SC3 (CCK)

Docelowa karta

Standardy

Webowy panel sterowania radiotelefonem TETRA Motorola sterowanym komendami AT przez interfejs PEI (RS232). Serwer eksponuje REST API, strumień zdarzeń SSE oraz pełno-dupleksowe audio przez WebRTC — dzięki temu z dowolnej przeglądarki można obsługiwać radio jak fizyczny panel czołowy: rozmowy grupowe i indywidualne, SDS, wybór talkgrupy, skanowanie, GPS, status sieci. Może też pracować jako pełna zdalna konsola operatorska: przechwytuje pozycje GPS innych radiotelefonów przez odpytywanie Remote SDS i wizualizuje je na mapie. Zaprojektowany do montażu w pojeździe (np. BMW R1250RT) z radiem schowanym w kufrze i panelem na telefonie. Nowszy wariant integruje interkom w kasku motocyklowym (Cardo) i bezprzewodowy przycisk PTT przez mostek ESP32.

Funkcje

• Pełne sterowanie radiem przez AT/PEI
• WebRTC full-duplex audio (RX/TX) z niskim opóźnieniem
• PTT z przeglądarki (klik, klawisz, ekran dotykowy)
• Bezprzewodowy przycisk PTT Bluetooth LE (ELET-PTT603E34)
• Mostek do kasku motocyklowego: ESP32 + interkom Cardo (HFP) — audio i PTT po Bluetooth
• Połączenia grupowe i indywidualne, SDS
• Wybór i skanowanie talkgrup
• GPS, RSSI, bateria, status sieci, alarm/TXI
• Przechwytywanie pozycji GPS innych radiotelefonów przez odpytywanie Remote SDS
• Wizualizacja pozycji terminali na mapie
• Praca jako pełna zdalna konsola operatorska
• Zdalne kasowanie alarmu i sterowanie wieloma funkcjami zdalnych terminali (wymaga zaprogramowania opcji w CPS)
• Multiplekser PEI (pei_mux) — współdzielony port dla svxlink + remotehead
• Watchdog radia — automatyczne odzyskiwanie połączenia z radiem
• HTTPS + opcjonalne uwierzytelnienie
• Service systemd, autostart

Architektura

Radiotelefon TETRA (Motorola MTM/MTP)
       |
   RS232 / PEI (AT, 9600 bps)
       |
       v
   /dev/ttyS2
       |
   pei_mux  (multiplexer: PTY symlinki, serializacja AT, broadcast URC)
       |          |
       v          v
  svxlink     tetra_remote_head  (serwer WWW)
              REST :443  SSE :443  WebRTC (audio)
                     |
                ALSA: radio_capture / radio_playback
                     |
              Przeglądarka (PWA, panel czołowy)

Wdrożenie docelowe: motocykl BMW R1250RT — radio w kufrze, telefon na kierownicy jako panel.

Przetestowane radia

Natywny klient Android dla odbiorników OpenWebRX+ (fork luarvique). Pozwala słuchać własnych serwerów SDR w terenie — z audio działającym w tle, skanerem pasm, monitorem TETRA i mapą APRS. Powstał, bo przeglądarka na Androidzie zawodzi w terenie: audio pada przy zgaszonym ekranie, a zerwanie LTE wymaga ręcznego odświeżania. To czysty klient do Twoich serwerów (obsługuje basic auth nginx) — nie zawiera ani nie obchodzi żadnego szyfrowania.

Funkcje

Wtyczka rozszerzająca OpenWebRX+ o tryb TETRA: demodulację π/4-DQPSK, dekodowanie warstw L1/L2/L3, odtwarzanie mowy w kodeku ACELP oraz dedykowany panel WWW z informacjami o sieci, połączeniach i terminalach — wszystko wprost w interfejsie OpenWebRX+.

Funkcje

• Demodulacja π/4-DQPSK (GNURadio)
• Dekodowanie protokołu L1/L2/L3 (osmo-tetra / tetra-rx)
• Odtwarzanie mowy — własna implementacja kodeka ACELP wg specyfikacji ETSI, w przeglądarce
• AFC z portu FLL
• Panel sieci: MCC, MNC, LA, Color Code, DL/UL, status szyfrowania, czas sieci
• Aktywne połączenia (call setup / connect / release / TX grant)
• GSSI / ISSI z rozróżnieniem prawdziwego ISSI od aliasów ESI
• Stan szczelin czasowych (Traffic / Control / Common-Ctrl / Reserved / Unalloc) z TTL
• Lista sąsiednich komórek (cell_id, carrier, DL freq, load)
• Aktywne SSI i zdarzenia rejestracji MS (LU Accept/Reject, attach/detach, auth)
• Wiadomości SDS z dekodowaniem protokołu i statusu doręczenia
• Pływające okno zdarzeń z filtrami, edytorem etykiet G/SSI, eksportem CSV, trybem zdalnym i kompaktowym

Narzędzie do przechwytywania i analizy sygnalizacji interfejsu radiowego TETRA przez PEI (Peripheral Equipment Interface) radiotelefonów Motorola (MTM800 / MTP850). Podłącza się do radia przez port szeregowy lub USB, włącza tryb śledzenia i na żywo dekoduje ramki — połączenia, rejestracje, SDS, GPS, SYSINFO. Dostępne jako aplikacja na Windows, aplikacja na Androida oraz narzędzie na komputer.

Funkcje

• Śledzenie sygnalizacji TETRA na żywo przez PEI radia
• Dekodowanie 30+ typów ramek (CALL, GROUP, REG, SDS, GPS/LIP, SYSINFO)
• Ekstrakcja identyfikatorów ISSI / GSSI
• Dekodowanie częstotliwości z ramki SYSINFO (pasmo, nośna, duplex)
• Nazwy PDU zgodne ze specyfikacją ETSI
• Automatyczne wykrywanie portu i identyfikacja radia
• Widok śledzenia z kolorowaniem, zakładki Szczegóły / Radio / Sieć / Statystyki
• Filtrowanie ramek i statystyki ruchu
• Kopiowanie linii śledzenia do schowka
• Ciemny motyw na wszystkich platformach

Przetestowane radia

Platformy