Integracja czujników z ATAK: od dalmierzy do odbiorników SDR

Dalmierz zna odległość do celu. Radiotelefon wie, kto jest w sieci. Odbiornik SDR wie, które częstotliwości są aktywne i gdzie znajdują się nadajniki. Żadna z tych informacji nie jest użyteczna, dopóki nie pojawi się na mapie operatora jako współdzielony, oznaczony czasowo obiekt, który reszta zespołu może zobaczyć i na który może zareagować. Ta transformacja – od surowego odczytu czujnika do znacznika we wspólnym obrazie sytuacyjnym – to dokładnie to, co robi dobrze zbudowana wtyczka integracji czujników ATAK. W tym artykule omówione są wzorce łączenia czujników polowych z ATAK, normalizacji ich bardzo różnych danych wyjściowych i publikowania czystych wykryć do COP bez zalewania go szumem.

Problem integracji: wiele czujników, jeden obraz

Czujniki polowe nie są zaprojektowane do interoperacji. Laserowy dalmierz emituje zasięg, azymut i kąt nachylenia przez profil szeregowy Bluetooth we własnym zastrzeżonym formacie zdań. Radiotelefon taktyczny udostępnia raporty pozycji i przynależność do sieci przez interfejs zdefiniowany programowo lub bramkę szeregową. Odbiornik SDR produkuje namiery określające kierunek i klasyfikacje sygnałów jako strumień ustrukturyzowanych rekordów przez gniazdo sieciowe. Każdy mówi innym transportem, innym ramkowaniem, innym systemem jednostek i inną konwencją współrzędnych.

ATAK dostarcza jedną rzecz, której wszystkie potrzebują: współdzielony przestrzenno-czasowy model danych. Każdy obiekt na mapie ATAK jest zdarzeniem Cursor on Target (CoT) – komunikatem XML opisującym co zostało zaobserwowane, gdzie, kiedy i z jaką pewnością. Zadanie wtyczki czujnikowej jest zatem wąskie i dobrze zdefiniowane: odbierz natywne wyjście czujnika, znormalizuj je do kanonicznego pomiaru, przekonwertuj ten pomiar na jedno lub więcej zdarzeń CoT i wstrzyknij te zdarzenia na wewnętrzną magistralę ATAK. Gdy pomiar jest zdarzeniem CoT, ATAK renderuje go, utrwala i federuje przez TAK Server do każdego podłączonego klienta bez dalszego zaangażowania wtyczki.

Właściwe ustawienie tego potoku to głównie kwestia dyscypliny na granicach. Strona czujnikowa jest nieuporządkowana i specyficzna dla urządzenia; strona CoT jest jednolita. Dobra wtyczka utrzymuje te dwa światy ściśle rozdzielone przez warstwę normalizacji, dzięki czemu obsługa nowego czujnika oznacza napisanie jednego adaptera zamiast przerabiania ścieżki publikowania.

Architektura wtyczki: trzy warstwy

Produkcyjna wtyczka integracji czujników dzieli się czysto na trzy warstwy, każda z jedną odpowiedzialnością.

1. Warstwa usługi czujnika. Ta warstwa jest właścicielem fizycznego lub logicznego połączenia z urządzeniem. Dla dalmierza Bluetooth zarządza gniazdem profilu portu szeregowego; dla urządzenia USB używa interfejsu API Android USB host ze sterownikiem USB-serial; dla mostu SDR utrzymuje klienta TCP do komputera towarzyszącego. Definiującą zasadą tej warstwy jest to, że nigdy nie dotyka wątku UI. Wszystkie wejścia/wyjścia urządzenia działają w dedykowanym wątku tła lub usłudze Android Service, ustrukturyzowanej jako jawny automat stanów connect / read / reconnect / disconnect. Surowe bajty są ramkowane na dyskretne odczyty i przekazywane dalej – nigdy tu nie parsowane pod względem znaczenia, tylko granic.

2. Warstwa normalizacji. Każdy typ czujnika ma adapter, który konwertuje jego surowy odczyt na jeden wewnętrzny model pomiaru. Ten model używa stałych jednostek przez cały czas: stopnie WGS84 dla pozycji, metry dla zasięgu i wysokości, stopnie względem północy rzeczywistej dla azymutu i UTC dla znaczników czasu. Adapter wykonuje przeliczanie jednostek (mils na stopnie, kurs magnetyczny na rzeczywisty z użyciem modelu deklinacji), transformacje układu odniesienia, gdy urządzenie raportuje w układzie innym niż WGS84, oraz szacowanie pewności. Wszystko poniżej zużywa tylko znormalizowany model, co sprawia, że architektura jest rozszerzalna.

3. Warstwa publikowania CoT. Ta warstwa mapuje znormalizowane pomiary na zdarzenia Cursor on Target i wstrzykuje je do ATAK. Decyduje o geometrii zdarzenia (punkt, linia lub wielokąt), kodzie typu CoT, strategii UID dla pomiarów śledzonych w porównaniu z jednorazowymi oraz czasie przedawnienia. Jest jedyną warstwą, która zna interfejsy API ATAK, co sprawia, że warstwy czujnika i normalizacji są przenośne i niezależnie testowalne.

Dlaczego warstwa normalizacji jest warta swojej ceny

Kuszące jest, przy integracji pojedynczego czujnika, pominięcie normalizacji i bezpośrednia konwersja danych wyjściowych urządzenia do CoT. Ten skrót załamuje się w chwili pojawienia się drugiego czujnika – a w terenie zawsze jest drugi czujnik. Przy jawnym modelu pomiaru korekcja deklinacji, obsługa układu odniesienia i logika pewności mieszkają w jednym miejscu i są testowane jednostkowo raz. Dodanie nowego modelu dalmierza staje się 100-liniowym adapterem, a zupełnie nowa klasa czujnika to nowy adapter plus jedna nowa reguła mapowania CoT. Bez tego każde nowe urządzenie przeciąga zmiany przez ścieżkę publikowania i ryzykuje regresję czujników, które już działają.

Dalmierze: kanoniczny czujnik punktowy

Laserowy dalmierz to najprostsza i najczęstsza integracja czujników ATAK, i stanowi szablon dla wszystkiego innego. Operator laseruje cel; urządzenie raportuje zasięg pochyły, azymut magnetyczny i kąt nachylenia. W połączeniu z własną pozycją operatora z GPS ATAK, te trzy liczby rozwiązują się do jednej współrzędnej celu.

Geometria to projekcja biegunowo-kartezjańska z lokalizacji operatora: przelicz azymut magnetyczny na rzeczywisty, stosując lokalną deklinację, rzutuj zasięg pochyły przez kąt nachylenia na odległość naziemną i deltę wysokości, i przesuń od znane pozycji czujnika, aby uzyskać współrzędną WGS84 celu. Wynik jest publikowany jako zdarzenie CoT typu punkt z przynależnością wrogi, przyjazny lub nieznany wybraną przez operatora, oraz czasem przedawnienia wystarczająco długim, aby być użytecznym, ale wystarczająco krótkim, aby porzucony strzał nie zalegał na mapie.

Dwa szczegóły implementacyjne powodują większość awarii w terenie. Pierwszym jest deklinacja: dalmierz raportuje kurs magnetyczny, a użycie go jako kursu rzeczywistego powoduje błąd celu, który rośnie z zasięgiem – przy 5 km kilka stopni nieskoryekowanej deklinacji umieszcza znacznik setki metrów dalej. Wtyczka musi stosować model deklinacji dla lokalizacji i daty operatora. Drugim jest pętla odczytu Bluetooth: dalmierze parują się przez profil portu szeregowego i emitują zdanie na strzał, ale jeśli odczyt działa w wątku UI, cały interfejs ATAK zacina się za każdym razem, gdy urządzenie ponownie się łączy. Odczyt musi znajdować się w usłudze czujnika w tle.

Radiotelefony: raporty pozycji i stan sieci

Radiotelefony taktyczne wnoszą dwa rodzaje danych do obrazu: pozycje samych radiotelefonów i stan sieci. Nowoczesne radiotelefony programowalne i urządzenia przenośne z możliwością transmisji danych udostępniają raporty pozycji przez bramkę szeregową lub IP, a wzorzec integracji ściśle odzwierciedla szerszą praktykę łączenia taktycznych radiotelefonów z oprogramowaniem. Każdy raport staje się zdarzeniem CoT pozycji ze stabilnym UID wywiedzionym z identyfikatora radiotelefonu, dzięki czemu ATAK wyświetla ruchomy znacznik sił przyjaznych zamiast śladu odłączonych punktów.

Stan sieci to subtelniejszy wkład. To, czy węzeł jest osiągalny, jaka jest jakość jego łącza i kiedy ostatnio raportował, są wszystkie operacyjnie znaczące. Zdolna wtyczka radiotelefonu wyraża to jako stylizację znacznika – węzeł, który nie raportował w oczekiwanym interwale, jest wizualnie postarzały lub wyszarzony – i opcjonalnie jako pole szczegółów CoT, aby narzędzia downstream mogły rozumować o kondycji łącza. Wtyczka nigdy nie powinna całkowicie usuwać nieaktualnego węzła; powinna pozwolić, aby czas przedawnienia CoT wyrażał niepewność, dzięki czemu operator rozumie różnicę między „potwierdzono zniknięcie" a „nie słyszano ostatnio".

Odbiorniki SDR: namiery, namierzenia i wzorzec komputera towarzyszącego

Odbiorniki definiowane programowo to najbardziej wymagająca klasa czujników do integracji, ponieważ ciężkie przetwarzanie sygnału rzadko działa na samym urządzeniu Android. Standardowe wdrożenie umieszcza platformę SDR i jej potok detekcji lub określania kierunku na komputerze towarzyszącym, przy czym wtyczka ATAK działa jako cienko-warstwowy konsument przez lokalne gniazdo sieciowe.

Potok SDR produkuje trzy użyteczne typy produktów. Pojedynczy namiar określający kierunek mapuje się na linię CoT rysowaną z pozycji czujnika wzdłuż zmierzonego azymutu, opcjonalnie z klinowatą strefą niepewności kątowej. Namierzenie wieloczujnikowe lub z ruchomą bazą mapuje się na punkt CoT z elipsą błędu wyrażającą pewność geolokalizacji. Klasyfikacja sygnału – typ nadajnika, modulacja, częstotliwość – dołącza jako szczegół CoT, dzięki czemu operator widzi nie tylko gdzie jest nadajnik, ale co prawdopodobnie jest. Ponieważ strona SDR działa asynchronicznie i z dużą częstotliwością, wtyczka musi ograniczać szybkość i deduplikować przed publikowaniem; surowy strumień namiarów z dziesiątkami hercami przytłoczyłby zarówno mapę, jak i federację TAK Server.

Publikowanie do COP bez zalewania go

Gdy pomiary są znormalizowane, dyscyplina warstwy publikowania decyduje, czy wtyczka pomaga czy przeszkadza. Trzy zasady rządzą dobrym zachowaniem. Po pierwsze, przypisz stabilny UID do wszystkiego, co powinno być śledzone – radiotelefon, trwały nadajnik – aby aktualizacje zastępowały istniejący znacznik zamiast tworzyć nowe; przypisz świeży UID tylko do prawdziwie niezależnych jednorazowych zdarzeń, jak pojedynczy strzał laserowy. Po drugie, dopasuj czas przedawnienia CoT do pewności: potwierdzony, wielokrotnie obserwowany ślad może trwać minutę lub dłużej, podczas gdy pojedyncze niepewne wykrycie powinno wygasnąć w ciągu sekund, aby samo się wyczyściło. Po trzecie, deduplikuj i ograniczaj szybkość u źródła, przed dotarciem zdarzenia do magistrali, aby federacja niosła sygnał, a nie szum.

Równie ważna jest szczerość co do stanu łącza. Polowa wtyczka czujnikowa musi zakładać, że sieć – a czasem samo łącze czujnikowe – ulegnie awarii. Pomiary są zapisywane do lokalnej kolejki natychmiast po rejestracji, opatrzone czasem rejestracji, a nie czasem publikacji, i opróżniane do CoT po przywróceniu połączenia. Panel wtyczki powinien zawsze pokazywać stan łącza czujnika, wiek ostatniego odczytu i wszelkie zaległości publikowania. Wtyczka, która cicho przestaje się aktualizować po rozłączeniu czujnika, jest gorsza niż żadna wtyczka, ponieważ prezentuje przestarzały obraz jako aktualny. Ta sama dyscyplina offline-first ma zastosowanie niezależnie od tego, czy feed pochodzi z ręcznego dalmierza, czy ze strumienia telemetrii drona.

Testowanie i walidacja polowa

Wtyczki czujnikowe zawodzą w sposób, który testy laboratoryjne rzadko wychwytują. Urządzenia Bluetooth renegocjują połączenia nieprzewidywalnie; GPS dryfuje pod okapem drzew; deklinacja zmienia się z lokalizacją; aktualizacje oprogramowania układowego cicho zmieniają formaty wyjściowe. Reprezentatywne przejście walidacji uruchamia wtyczkę na rzeczywistym wytrzymałym sprzęcie Android, który jednostka wdraża, z prawdziwym czujnikiem, przy przerwanej łączności i z zachowaniem dotykowym oczekiwanym od rąk w rękawiczkach. Zbierz rzeczywiste dane wyjściowe urządzenia wcześnie – karty danych kłamią, a jedynym wiarygodnym źródłem prawdy dla zdania wyjściowego jest urządzenie w ręku. Potwierdź, że współrzędne celu ze strzału dalmierza lądują tam, gdzie punkt kontrolny mówi, że powinny, i że obraz degraduje się łagodnie, a nie zwodniczo, gdy czujnik wypadnie.