Přeskočit na hlavní obsah
Tato stránka je překlad. Liší-li se od anglického originálu, platí anglické znění.
·Celý oddíl Konfigurace (6 stránek)·Celá příručka Dronetag Scout (31 stránek)

Konfigurace senzoru

Přeposílání dat Dronetag ze Scoutu

Integrace určují, kam a jak Scout posílá telemetrii. Scout umí provozovat několik forwarderů souběžně. Pokud některá instance data nezpracovává dost rychle, ostatních instancí se to nedotkne.

Existují dva základní forwardery:

  • forwardery Dronetag (jeden pro Cloud a jeden pro On-Premise), které lze jen zapnout či vypnout a velmi jednoduše nastavit,
  • forwardery JSON, které jsou univerzální a určené pro vlastní integrace uživatele.

Popis formátu dat najdete na konci této stránky.

Forwardery Dronetag​

Přeposílání dat Dronetag ze Scoutu

Dronetag Cloud je jediný (uživateli viditelný) trvalý forwarder. Nelze ho smazat, ale lze ho vypnout. Vypnutím cloudového forwarderu přestanete Scout i jeho detekce vidět v aplikaci Dronetag.

Můžete přidat integraci Dronetag On-Premise a mít tak plnou kontrolu nad svými daty se všemi výhodami našeho cloudového backendu.

Forwarder Dronetag lze používat souběžně s libovolnými dalšími forwardery. Podrobnosti o provozu Scoutu v režimu Cloud Mode nebo On-Premise Mode najdete na této stránce.

Forwardery JSON​

Forwardery JSON jsou určené pro vlastní integrace uživatele.

Všechny vlastní forwardery lze zabezpečit a podporují kompresi i dávkování.

Základní nastavení MQTT pro přeposílání dat ze Scoutu

Port je lepší uvést přímo v poli URL, jinak se použije 1883. Pro čisté MQTT(s) stačí host:port. Chystáte-li se použít WebSockets, můžete uvést i cestu, jinak se použije /.

  • MQTT over WebSockets: připojení k brokeru MQTT přes WebSockets místo nativního protokolu MQTT. Hodí se tam, kde můžete použít jen spojení HTTP/WebSocket (například za přísným firewallem).
  • Drones Topic: téma MQTT pro detekce dronů. Témata fungují jako adresáře v souborovém systému. Šablona: {sn} pro celé sériové číslo, {sn4} pro poslední 4 číslice. Příklad: myorg/receivers/scout1/drones
  • Aviation Topic: samostatné téma MQTT pro data o letovém provozu. Zůstane-li prázdné, posílají se tato data do Drones Topic.
  • Status Topic: samostatné téma MQTT pro stav Scoutu (heartbeat). Zůstane-li prázdné, posílá se stav do Drones Topic.

Následují společné volby bez ohledu na základní protokol (HTTP/MQTT).

Základní nastavení​

Tyto volby jsou nutné u každého forwarderu:

  • Enabled: zapne nebo vypne tento forwarder. Ve vypnutém stavu se jím žádná data neposílají.
  • URL: cíl, kam se data posílají. Neodhadujte prosím protokol — použijte zaškrtávací volby pro zabezpečené spojení, mTLS nebo pro přepnutí protokolu na web sockets.
  • Sources: vyberte, které typy dat se mají přeposílat: drones (telemetrie detekovaných dronů), aviation (data o pilotovaných letadlech z leteckého modulu), status (kondice a poloha Scoutu). Pamatujte, že drony a letový provoz omezuje globální filtr na výšku a vzdálenost.
  • Client Timeout: jak dlouho (v sekundách) se čeká na odpověď serveru, než se spojení považuje za přerušené. Výchozí hodnota je 15 sekund. Zvyšte ji, pokud je vaše spojení nespolehlivé nebo pomalé.

Dávkování​

Dávkování seskupí několik zpráv před odesláním. Snižuje tím síťový provoz i zátěž serveru, ale přidává malé zpoždění. Zde určujete tato zpoždění a způsob formátování dat.

  • Enable Batching: zapne nebo vypne dávkování zpráv. Hodí se při velkých objemech.
  • Batch as JSON Array: je-li zapnuto, seskupí se zprávy jako [msg1, msg2, ...]. Je-li vypnuto, spojí se zprávy oddělovačem.
  • Items Separator: znak nebo znaky mezi zprávami při zapnutém dávkování: nothing (bez oddělovače), \r\n (návrat vozíku + nový řádek) nebo \n (nový řádek).
  • Batch Size: maximální počet zpráv seskupených před odesláním. Hodnota 0 dávkování vypne, jinak zadejte číslo, například 100.
  • Batch Timeout: maximální počet sekund, po které se čeká na odeslání dávky, i když není plná. Například 0.1 odesílá dávky každých 100 ms. Hodnota 0 tuto volbu vypne.

Příklad: Při Batch Size = 100 a Timeout = 0,1 sekundy se dávka odešle buď po 100 zprávách, NEBO po 0,1 sekundy — podle toho, co nastane dřív.

Komprese​

  • Compression: sníží objem přenášených dat jejich kompresí před odesláním. Pozor: u HTTP se data komprimují volitelně jen tehdy, když to dává smysl. Komprese se pak uvádí v hlavičce Content-Encoding (s hodnotou „gzip“). Zvolíte-li ji pro MQTT, komprimují se data vždy, protože u MQTT není jak kompresi naznačit.

Nastavení zabezpečení​

Nastavení zabezpečení přeposílání dat ze Scoutu

Zde nastavíte, jak Scout bezpečně komunikuje s vaším serverem.

Šifrování serveru TLS/SSL​

Tato část se týká pouze ověřování certifikátu serveru. Je to nejběžnější část zabezpečení a nejspíš ji potřebujete mít správně.

  • Secured: zapne šifrování TLS pro spojení. Používá-li váš server HTTPS nebo MQTTs, zapněte ji.
  • Verify Server Cert: ověří, že je certifikát serveru platný a nevypršel. Vypněte jen při testování s certifikáty podepsanými sám sebou. Varování: vypnutím se vystavujete útoku typu man-in-the-middle.
  • Verify Server Domain/IP: ověří, že název v certifikátu (pole CN) odpovídá serveru, ke kterému se připojujete. Zapnutím zabráníte připojení k podvrženým serverům.
  • Server CA Certificate: váš vlastní certifikát CA ve formátu PEM (soubor .pem nebo .crt). Říká Scoutu, které certifikační autoritě má důvěřovat. Obvykle je potřeba, když má vaše organizace vlastní interní CA. Pozor, musí jít o kořenovou CA z certifikátu serveru, nikoli o mezilehlou.

Klientské certifikáty​

V této části zadáte své klientské certifikáty pro mTLS. Ve světě MQTT je to běžné a stále častěji i u HTTP.

  • Client Certificate: nahrajte certifikát, kterým se Scout autentizuje vůči vašemu serveru. Je potřeba, pokud váš server klientské certifikáty kontroluje (vzájemné TLS). Formát souboru: PEM.
  • Client Private Key: privátní klíč odpovídající vašemu klientskému certifikátu. Potřeba jen tehdy, není-li klíč vložený přímo v souboru s certifikátem.
  • Client Key Password: je-li váš privátní klíč zašifrovaný, zadejte sem heslo.

Nastavení autentizace​

Pro servery, které vyžadují přihlašovací údaje:

  • Username: uživatelské jméno pro HTTP Basic Auth nebo pro autentizaci MQTT. Při autentizaci tokenem nechte prázdné.
  • Password/Token: heslo pro Basic Auth nebo token API. Ukládá se bezpečně. U MQTT to podle nastavení vašeho brokeru může být heslo nebo token.

Omezení dosahu a výšky senzorů​

Prahy senzoru pro letový provoz

Pro data o dronech i o letovém provozu můžete zvolit prahové hodnoty:

  • prahy pro ignorování (vzdálenost, výška): objekt dál NEBO výš než limit se tiše zahodí,
  • prahy pro sledování (vzdálenost, výška): objekty blíž A níž než limity se sledují.

Sledování znamená, že se u zpráv neuplatní omezení četnosti. Přepošle se každá zpráva. Omezení četnosti znamená, že se odešle jen jedna zpráva za (nastavitelných) X sekund na objekt. Dobře zvolené limity oceníte hlavně u letového provozu, kde je průměrná spotřeba dat poblíž středně velkého letiště bez limitů zhruba 150 MB/den.

Výchozí limity​

Pro drony je ve výchozím stavu omezení četnosti i ignorování vypnuté — všechny hodnoty jsou 0.

Letový provoz je ve výchozím stavu omezený, protože je viditelný na velké vzdálenosti, které nejsou pro běžný provoz užitečné. Letový provoz se proto ignoruje dál než 100 km bez ohledu na výšku (práh pro ignorování). Sledování letového provozu (bez omezení četnosti) probíhá ve výchozím stavu u veškerého provozu do 10 km a pod 1000 m výšky (přistávající objekty).

pozor

Integrace BEAST a ADSBExchange se tyto limity netýkají. Přenášejí surový, nedekódovaný proud BEAST z přijímače, který neobsahuje žádné polohy, podle kterých by Scout mohl filtrovat — přepošle se všechno, co přijímač zachytí, bez ohledu na vzdálenost a výšku. Beast Reduction omezuje jen četnost aktualizací na letadlo, nikoli pokrytí.

Formáty​

Všechny forwardery založené na JSON podporují dva formáty: dri a odid. Formát DRI obsahuje surovou zprávu OpenDroneID (jako bajty) tak, jak ji anténa přijala. Zpráva ODID je rozparsovaná a převedená zpráva OpenDroneID, se kterou se pracuje příjemněji.

Každá zpráva se posílá samostatně, pokud není nastavené dávkování. Podrobnosti o dávkování zpráv najdete výše.

Pole JSON ODID​

KlíčTypPříkladPopis
snstr1000033Sériové číslo
macstrMAC ve tvaru XX:YY:ZZ:AA:BB:CC; u letového provozu odvozená z adresy ICAO/zařízení
counterint13Počítadlo přijatých zpráv (0 u letového provozu)
rssiint-57Síla signálu v dBm
techstr[2]B5Technologie příjmu: B4, B5, WN, WB (Remote ID dronů); AB, AL, UT, FL, OG (letový provoz)
recv_idintID přijímače
module_idint2Číslo antény nebo modulu
module_typeint11Interní typ modulu; u letového provozu přijímací kmitočet v MHz (1090, 978, 868)
msg_typeint15Typ zprávy ODID; letový provoz přichází vždy jako 15 (Pack)
noise_floorint | null-98Úroveň šumu v dBm, pokud ji přijímací čip hlásí
registrationobject | null-Výrobce a model dronu určený offline ze sériového čísla Remote ID. K dispozici pouze na Scout Sensor+ s platnou licencí, jinak null
odiddict-Obsahuje předzpracovaná data protokolu. Možné hodnoty a strukturu zpráv najdete v knihovně ODID. Podrobnosti také v úplném popisu protokolu níže

Strojově čitelné schéma​

Závazný, verzovaný popis celé zprávy JSON+ODID je publikovaný jako JSON Schema (draft 2020-12) generované přímo z typovaných datových modelů senzoru — každé pole má popis s jednotkami, platnými rozsahy a významem hodnoty null, včetně toho, jak se letový provoz (ADS-B, ADS-L, UAT, FLARM, OGN) mapuje do struktury ODID (identifikátor letadla v BasicID, číslo letu nebo volací znak v SelfID, nikdy zpráva System).

Ke stažení: scout-json-odid.schema-v1.0.json

Verze schématu (version a $id uvnitř souboru) se zvyšuje při každé změně formátu na drátě, takže si vaše integrace může zafixovat konkrétní revizi schématu. Použijte ho ke generování typovaných klientských modelů nebo k validaci přijatých zpráv v CI.

varování

Textový formát JSON se surovými poli rozparsovanými ze zdrojů ODID je níže uvedený jen jako názorná ukázka; odesílaný formát se navíc liší takto:

  • bez odsazení — objekt je vždy na jediném řádku, protože se posílá jako JSONL,
  • všechna neplatná pole se zpracují a převedou na null (příklad: Lat, Lon 0,0 se převede na null).

Ukázkové zprávy JSON ODID​

{
    "sn": "D11234567812345678",
    "mac": "ab:ab:bc:bc:de:de",
    "counter": 24,
    "rssi": -83,
    "tech": "B4",
    "recv_id": 0,
    "module_id": 0,
    "module_type": 10,
    "msg_type": 1,
    "noise_floor": null,
    "registration": {
        "maker": "Dronetag",
        "model": "Beacon gen.2",
        "type": "rid_module",
        "certain": true
    },
    "odid": {
        "BasicID": [
            {
                "UAType": 15,
                "IDType": 1,
                "UASID": "159112345678"
            }
        ],
        "Location": {
            "Status": 2,
            "Direction": 202.0,
            "SpeedHorizontal": 16.5,
            "SpeedVertical": 0.0,
            "Latitude": 50.0835017,
            "Longitude": 14.4328954,
            "AltitudeBaro": 95.0,
            "AltitudeGeo": 0.0,
            "HeightType": 1,
            "Height": 163.0,
            "HorizAccuracy": 0,
            "VertAccuracy": 0,
            "BaroAccuracy": 0,
            "SpeedAccuracy": 0,
            "TSAccuracy": 0,
            "Timestamp": "2026-06-01T09:49:11",
            "TimestampEstimated": false
        },
        "SelfID": null,
        "System": null,
        "OperatorID": {
            "OperatorIdType": 0,
            "OperatorId": "d6lE0m0Hi2iNx"
        }
    }
}
varování

Bluetooth Legacy, tedy tech=B4, posílá každý typ zprávy (System, Location…) samostatně. Zprávy PACKED se přes B4 nepodporují. Agregace může přibýt později. Agregace přibyla v ScoutOS 2026.05.29. Zprávy Bluetooth Legacy se agregují, dokud nedorazí platná zpráva Location, a pak se celý agregát pošle dál jako zpráva PACKED. Agregát se poté odešle s každou aktualizovanou zprávou Location, protože ostatní pole se mění jen zřídka.

  • Poznámka: Podobně se mohou chovat i ostatní technologie; záleží na implementaci vysílače. Obecně Wi-Fi Beacon, Wi-Fi NaN a Bluetooth 5 Long Range posílají všechny informace v jediném balíku, ale zaručené to není. Neznáme vysílač, který by to dělal jinak, ale možné to je. Při zpracování tedy počítejte s tím, že nemusí být platné všechny informace, ať předejdete zbytečným pádům.

Heartbeat / stav​

Zvolíte-li pro svůj forwarder zdroj status, budete dostávat stavovou zprávu každých 60 s. Tyto zprávy obsahují:

  • základní informace o zařízení,
  • polohu GNSS (je-li GNSS zapnuto),
  • stav sítě LTE (je-li osazen modem LTE),
  • podrobnosti o senzorech.

Ukázková zpráva heartbeat:

{
    "sn": "D11234567812345678",
    "timestamp": 1780310741,
    "receivers": 2,
    "last_observation": 1780310741,
    "gnss_available": true,
    "gnss_position": [
        50.073992633,
        14.466609883
    ],
    "gnss_satellites": 6,
    "gnss_altitude": 262.5,
    "gsm": {
        "enabled": true,
        "state": "connected",
        "quality": 100,
        "tech": "lte"
    },
    "sensors": [
        {
            "id": "RW1",
            "uid": 2,
            "source": "wifi/dri_wlp1s0u1u2",
            "state": "ok",
            "timestamp": 1780310741.7995672,
            "tech": "RemoteID",
            "messages": 0,
            "filtered": 0,
            "last_message_at": 0,
            "last_status_at": 0,
            "extras": {
                "module_type": 10,
                "module_type_name": "RW1",
                "module_revision": 0
            }
        },
        {
            "id": "ADS-B",
            "uid": 18873,
            "source": "18873",
            "state": "ok",
            "timestamp": 1780310741.7998254,
            "tech": "ADS-B",
            "messages": 32588,
            "filtered": 32588,
            "last_message_at": 1780310741,
            "last_status_at": 0,
            "extras": {
                "export_running": false,
                "export_size": 0
            }
        }
    ]
}

Ke stažení​

Specifikace formátu senzoru Scout (v2.5)

Schéma JSON+ODID (v1.0)

Katalogový list SCOUT (v2.4, nahrazený specifikací formátu)