Інтеграція сенсорів в ATAK: від далекомірів до SDR-приймачів

Далекомір знає відстань до цілі. Радіостанція знає, хто в мережі. SDR-приймач знає, які частоти активні і де знаходяться випромінювачі. Жодне з цих знань не є корисним, доки воно не з'являється на карті оператора як спільний, позначений часом об'єкт, який може бачити і діяти за ним вся команда. Це перетворення — від необробленого показника сенсора до маркера на загальній оперативній картині — саме те, що робить добре розроблений плагін інтеграції сенсорів ATAK. Ця стаття розглядає патерни підключення польових сенсорів до ATAK, нормалізації їх різноманітних виходів та публікації чистих виявлень на COP без завалення його шумом.

Проблема інтеграції: багато сенсорів, одна картина

Польові сенсори не розроблені для взаємодії. Лазерний далекомір видає дальність, азимут і кут нахилу через Bluetooth-профіль послідовного порту у власному форматі рядків. Тактична радіостанція надає звіти про місцезнаходження та членство в мережі через програмно визначений інтерфейс або послідовний шлюз. SDR-приймач виробляє пеленги та класифікації сигналів у вигляді потоку структурованих записів через мережевий сокет. Кожен говорить різним транспортом, різним обрамленням, різною системою одиниць і різною конвенцією координат.

ATAK надає єдине, що їм усім потрібно: спільну просторово-часову модель даних. Кожен об'єкт на карті ATAK є подією Cursor on Target (CoT) — XML-повідомленням, що описує, що спостерігалося, де, коли і з якою достовірністю. Завдання плагіна сенсора є вузьким і чітко визначеним: отримати рідний вивід сенсора, нормалізувати його до канонічного вимірювання, перетворити це вимірювання на одну або кілька подій CoT та ввести ці події на внутрішню шину ATAK. Після того як вимірювання стає подією CoT, ATAK відображає, зберігає і федерує його через TAK Server до кожного підключеного клієнта без подальшої участі плагіна.

Правильна побудова цього конвеєра — переважно питання дисципліни на межах. Сторона сенсора є брудною і залежить від пристрою; сторона CoT є однорідною. Хороший плагін суворо розділяє ці два світи шаром нормалізації, щоб підтримка нового сенсора означала написання одного адаптера, а не переробку шляху публікації.

Архітектура плагіна: три шари

Промисловий плагін інтеграції сенсорів чітко розділяється на три шари, кожен з єдиною відповідальністю.

1. Шар сервісу сенсора. Цей шар відповідає за фізичне або логічне з'єднання з пристроєм. Для Bluetooth-далекоміра він керує сокетом профілю послідовного порту; для USB-пристрою використовує Android USB host API з USB-серійним драйвером; для SDR-мосту утримує TCP-клієнт до супутнього комп'ютера. Визначальне правило цього шару: він ніколи не торкається потоку UI. Увесь введення/виведення пристрою виконується у виділеному фоновому потоці або Android Service, структурованому як явний автомат станів підключення / зчитування / перепідключення / відключення. Необроблені байти обрамляються в окремі показники і передаються далі — тут їх ніколи не аналізують на значення, лише на межі.

2. Шар нормалізації. Кожен тип сенсора має адаптер, що перетворює його необроблений показник на єдину внутрішню модель вимірювань. Ця модель використовує фіксовані одиниці: градуси WGS84 для позиції, метри для дальності та висоти, градуси від справжньої півночі для азимуту і UTC для міток часу. Адаптер виконує конвертацію одиниць (поділки на градуси, магнітний курс на справжній з використанням моделі магнітного схилення), перетворення датуму там, де пристрій звітує у не-WGS84 датумі, та оцінку достовірності. Усе нижче за потоком споживає лише нормалізовану модель, що і робить архітектуру розширюваною.

3. Шар публікації CoT. Цей шар відображає нормалізовані вимірювання на події Cursor on Target і вводить їх до ATAK. Він вирішує геометрію події (точка, лінія або полігон), код типу CoT, стратегію UID для відстежуваних або одноразових вимірювань і час застарівання. Це єдиний шар, що знає про API ATAK, що дозволяє шарам сенсора та нормалізації залишатися переносимими та незалежно тестованими.

Чому шар нормалізації виправдовує себе

При інтеграції одного сенсора виникає спокуса пропустити нормалізацію та перетворити вивід пристрою безпосередньо на CoT. Цей скорочений шлях руйнується в момент появи другого сенсора — а в полі завжди є другий сенсор. При наявності явної моделі вимірювань корекція магнітного схилення, обробка датуму та логіка достовірності знаходяться в одному місці та тестуються один раз. Додавання нової моделі далекоміра стає адаптером на 100 рядків, а абсолютно новий клас сенсора — новим адаптером плюс одним новим правилом відображення CoT. Без цього кожен новий пристрій тягне зміни через шлях публікації і ризикує зламати вже працюючі сенсори.

Далекоміри: канонічний точковий сенсор

Лазерний далекомір є найпростішою і найпоширенішою інтеграцією сенсора ATAK, і він задає шаблон для всього іншого. Оператор лазерує ціль; пристрій повідомляє похилу дальність, магнітний азимут і кут нахилу. У поєднанні з власною позицією оператора від GPS ATAK ці три числа визначають єдину координату цілі.

Геометрія — це проєкція з полярних у декартові координати від місцезнаходження оператора: перетворіть магнітний азимут у справжній азимут, застосувавши місцеве магнітне схилення, спроектуйте похилу дальність через кут нахилу на наземну відстань і різницю висот та зміщення від відомої позиції сенсора для отримання координати цілі WGS84. Результат публікується як точкова подія CoT з ворожою, дружньою або невідомою приналежністю, обраною оператором, і часом застарівання, достатньо довгим, щоб бути корисним, але достатньо коротким, щоб покинуте лазерування не залишалося на карті.

Два деталі реалізації спричиняють більшість польових відмов. Перша — магнітне схилення: далекомір повідомляє магнітний курс, і використання його як справжнього курсу призводить до помилки в позиції цілі, що зростає з дальністю — на 5 км кілька градусів не скоригованого магнітного схилення розміщують маркер на сотні метрів не там. Плагін повинен застосовувати модель магнітного схилення для місцезнаходження та дати оператора. Друга — цикл зчитування через Bluetooth: далекоміри з'єднуються через профіль послідовного порту та видають один рядок за постріл, але якщо зчитування виконується в потоці UI, весь інтерфейс ATAK заїкається при кожному перепідключенні пристрою. Зчитування повинне знаходитися у фоновому сервісі сенсора.

Радіостанції: звіти про місцезнаходження та стан мережі

Тактичні радіостанції надають два види даних на картину: позиції самих радіостанцій та стан мережі. Сучасні програмно визначені радіостанції та цифрові портативні пристрої надають звіти про місцезнаходження через послідовний або IP-шлюз, і патерн інтеграції тісно відображає ширшу практику підключення тактичних радіостанцій до програмного забезпечення. Кожен звіт стає позиційною подією CoT зі стабільним UID, похідним від ідентифікатора радіостанції, тому ATAK відображає рухомий маркер дружніх сил, а не слід роз'єднаних точок.

Стан мережі — більш тонкий внесок. Те, чи вузол доступний, яка якість його каналу і коли він востаннє звітував, — усе це є оперативно значущим. Здатний плагін радіостанції відображає це у стилізації маркерів — вузол, який не звітував протягом очікуваного інтервалу, візуально старіє або сіріє — і за необхідності як поле деталей CoT, щоб низхідні інструменти могли аналізувати стан каналу. Плагін ніколи не повинен видаляти застарілий вузол напряму; він повинен давати часу застарівання CoT виражати невизначеність, щоб оператор розумів різницю між «підтверджено відсутній» і «нещодавно не чути».

SDR-приймачі: пеленги, прив'язки та патерн супутнього комп'ютера

SDR-приймачі є найбільш вимогливим класом сенсорів для інтеграції, оскільки важка обробка сигналів рідко виконується на самому Android-пристрої. Стандартне розгортання розміщує платформу SDR та її конвеєр виявлення або визначення напрямку на супутньому комп'ютері, а плагін ATAK виступає тонким споживачем через локальний мережевий сокет.

Конвеєр SDR видає три корисні типи продуктів. Одиничний пеленг від визначення напрямку відображається на лінію CoT, проведену від позиції сенсора вздовж виміряного азимуту, за можливості з кутовим клином невизначеності. Багатосенсорна або рухома базова прив'язка відображається на точку CoT з еліпсом похибки, що виражає достовірність геолокації. Класифікація сигналу — тип випромінювача, модуляція, частота — прикріплюється як деталь CoT, щоб оператор бачив не лише де є випромінювач, а й що він, швидше за все, собою являє. Оскільки сторона SDR працює асинхронно і з високою частотою, плагін повинен обмежувати швидкість та дедублювати перед публікацією; необроблений потік пеленгів десятками Гц перевантажить і карту, і федерацію TAK Server.

Публікація на COP без перевантаження

Після нормалізації вимірювань дисципліна шару публікації визначає, чи плагін допомагає або шкодить. Три правила регулюють хорошу поведінку. По-перше, призначайте стабільний UID усьому, що повинне відстежуватися — радіостанції, постійному випромінювачу — щоб оновлення замінювали наявний маркер, а не породжували нові; призначайте новий UID лише дійсно незалежним одноразовим подіям, як одиничне лазерування. По-друге, узгоджуйте час застарівання CoT з достовірністю: підтверджений, неодноразово спостережуваний трек може зберігатися хвилину або більше, тоді як одиночне невпевнене виявлення повинне застарівати за секунди, щоб самоочищатися. По-третє, дедублюйте та обмежуйте швидкість у джерелі, до того як подія досягне шини, щоб федерація несла сигнал, а не шум.

Не менш важливою є чесність щодо стану каналу. Польовий плагін сенсора повинен припускати, що мережа — а іноді й сам канал сенсора — буде обриватися. Вимірювання записуються до локальної черги в момент їх захоплення, позначаються часом захоплення, а не часом публікації, і скидаються до CoT після відновлення зв'язку. Панель плагіна повинна завжди показувати стан каналу сенсора, вік останнього зчитування та будь-яке накопичення черги публікацій. Плагін, який тихо припиняє оновлення при відключенні сенсора, є гіршим, ніж відсутність плагіна взагалі, оскільки він представляє застарілу картину як актуальну. Та сама офлайн-першість дисципліни застосовується незалежно від того, чи надходження є ручним далекоміром або потоком телеметрії дрона.

Тестування та польова перевірка

Плагіни сенсорів відмовляють способами, які стендове тестування рідко виявляє. Bluetooth-пристрої непередбачувано перепідключаються; GPS дрейфує під деревним покривом; магнітне схилення змінюється з місцезнаходженням; оновлення прошивки тихо змінюють формати виводу. Репрезентативна перевірка запускає плагін на справжньому захищеному Android-обладнанні, що розгортає підрозділ, з реальним сенсором, за переривчастого зв'язку та з поведінкою дотиків, очікуваною від рукавичок. Захопіть реальний вивід пристрою рано — технічні паспорти брешуть, і єдиним надійним джерелом правди для вихідного рядка є пристрій у руках. Підтвердіть, що координати цілі від лазерування далекоміра потрапляють туди, де каже контрольна точка геодезичної зйомки, і що картина деградує плавно, а не обманливо, коли сенсор відключається.