Příjem telemetrie antény v reálném čase
Stanice Azure Orbital Ground vysílá telemetrické události antény, které je možné použít k analýze provozu pozemní stanice během kontaktu. Svůj profil kontaktu můžete nakonfigurovat tak, aby odesílal telemetrické události do služby Azure Event Hubs.
V této příručce se naučíte tyto postupy:
- Konfigurace služby Azure Event Hubs pro azure Orbital Ground Station
- Povolte v profilu kontaktu telemetrii.
- Ověření obsahu telemetrických dat
- Principy telemetrických bodů
Konfigurace služby Event Hubs
- V předplatném přejděte v nastavení na poskytovatele prostředků. Vyhledejte Microsoft.Orbital a zaregistrujte ho jako poskytovatele.
- Vytvořte obor názvů služby Azure Event Hubs a centrum událostí ve vašem předplatném.
Poznámka:
Zvolte veřejný přístup pro přístup k připojení k EventHubs. Privátní přístup nebo koncové body služby se nepodporují.
- V nabídce vlevo vyberte Řízení přístupu (IAM). V části Udělit přístup k tomuto prostředku vyberte Přidat přiřazení role.
Poznámka:
Pokud chcete přiřadit role Azure, musíte mít: Microsoft.Authorization/roleAssignments/write oprávnění, jako je správce uživatelských přístupů nebo vlastník.
- Na kartě Role vyhledejte a vyberte odesílatele dat služby Azure Event Hubs. Klikněte na tlačítko Další.
- Na kartě Členové přiřaďte přístup k uživateli, skupině nebo instančnímu objektu.
- Klikněte na +Vybrat členy.
- Vyhledejte poskytovatele prostředků Azure Orbital a klikněte na Vybrat.
- Klikněte na Zkontrolovat a přiřadit. Tato akce uděluje stanici Azure Orbital Ground práva k odesílání telemetrie do centra událostí.
- Pokud chcete potvrdit nově přidané přiřazení role, vraťte se na stránku Řízení přístupu (IAM) a vyberte Zobrazit přístup k tomuto prostředku. Poskytovatel prostředků Azure Orbital by měl být pod odesílatelem dat služby Azure Event Hubs.
Povolení telemetrie služby Event Hubs pro profil kontaktu
Profil kontaktu nakonfigurujte následujícím způsobem:
- Zvolte obor názvů pomocí rozevíracího seznamu Obor názvů služby Event Hubs.
- Zvolte instanci pomocí rozevíracího seznamu Instance služby Event Hubs, který se zobrazí po výběru oboru názvů.
Nastavení existujícího profilu kontaktu můžete aktualizovat podle
Ověření telemetrických dat antény z kontaktu
Naplánujte kontakty pomocí profilu kontaktu, který jste dříve nakonfigurovali pro telemetrii služby Event Hubs. Jakmile kontakt začne, měli byste brzy začít zobrazovat data ve službě Event Hubs.
Stav i obsah příchozích telemetrických dat můžete ověřit několika způsoby.
Řídicí panel oboru názvů služby Event Hubs
Pokud chcete ověřit, že se události přijímají ve službě Event Hubs, můžete zkontrolovat grafy, které jsou přítomné na stránce přehledu oboru názvů služby Event Hubs ve vaší skupině prostředků. Toto zobrazení zobrazuje data napříč všemi instancemi služby Event Hubs v rámci oboru názvů. Můžete přejít na stránku přehledu konkrétní instance centra událostí ve vaší skupině prostředků a zobrazit grafy pro danou instanci.
Doručování telemetrických dat antény do účtu úložiště
Funkci Event Hubs Capture můžete povolit tak, aby automaticky doručovat telemetrická data do účtu služby Azure Blob Storage podle vašeho výběru. Podle pokynů povolte funkci Capture a capture data do úložiště Azure. Po povolení můžete zkontrolovat kontejner a zobrazit nebo stáhnout data.
Principy telemetrických bodů
Aktuální verze schématu telemetrie: 4.1
Pozemní stanice poskytuje telemetrii pomocí Avro jako schématu. Schéma je uvedené níže. Všimněte si, že antény Microsoftu generují telemetrii po přijetí prvního datového bodu. Telemetrie se hlásí pomocí přístupu "poslední známá hodnota", což znamená, že vždy pošleme nejnovější hodnotu, kterou máme pro metriku. Vzhledem k tomuto chování se může zobrazit NULL hodnota v první sekundě kontaktu, dokud se tato metrika nevytvorí jako první.
{
"namespace": "EventSchema",
"name": "TelemetryEventSchema",
"type": "record",
"fields": [
{
"name": "version",
"type": [ "null", "string" ]
},
{
"name": "contactId",
"type": [ "null", "string" ]
},
{
"name": "contactPlatformIdentifier",
"type": [ "null", "string" ]
},
{
"name": "groundStationName",
"type": [ "null", "string" ]
},
{
"name": "antennaType",
"type": {
"name": "antennaTypeEnum",
"type": "enum",
"symbols": [
"Microsoft",
"KSAT"
]
}
},
{
"name": "antennaId",
"type": [ "null", "string" ]
},
{
"name": "spacecraftName",
"type": [ "null", "string" ]
},
{
"name": "gpsTime",
"type": [ "null", "double" ]
},
{
"name": "utcTime",
"type": "string"
},
{
"name": "azimuthDecimalDegrees",
"type": [ "null", "double" ]
},
{
"name": "elevationDecimalDegrees",
"type": [ "null", "double" ]
},
{
"name": "contactTleLine1",
"type": [ "null", "string" ]
},
{
"name": "contactTleLine2",
"type": [ "null", "string" ]
},
{
"name": "links",
"type": [
"null",
{
"type": "array",
"items": {
"name": "antennaLink",
"type": "record",
"fields": [
{
"name": "name",
"type": [ "null", "string" ]
},
{
"name": "direction",
"type": {
"name": "directionEnum",
"type": "enum",
"symbols": [
"Uplink",
"Downlink"
]
}
},
{
"name": "polarization",
"type": {
"name": "polarizationEnum",
"type": "enum",
"symbols": [
"RHCP",
"LHCP",
"linearVertical",
"linearHorizontal"
]
}
},
{
"name": "uplinkEnabled",
"type": [ "null", "boolean" ]
},
{
"name": "channels",
"type": [
"null",
{
"type": "array",
"items": {
"name": "antennaLinkChannel",
"type": "record",
"fields": [
{
"name": "name",
"type": [ "null", "string" ]
},
{
"name": "modemName",
"type": [ "null", "string" ]
},
{
"name": "digitizerName",
"type": [ "null", "string" ]
},
{
"name": "endpointName",
"type": "string"
},
{
"name": "inputEbN0InDb",
"type": [ "null", "double" ]
},
{
"name": "inputEsN0InDb",
"type": [ "null", "double" ]
},
{
"name": "inputRfPowerDbm",
"type": [ "null", "double" ]
},
{
"name": "outputRfPowerDbm",
"type": [ "null", "double" ]
},
{
"name": "packetRate",
"type": [ "null", "double" ]
},
{
"name": "gapCount",
"type": [ "null", "double" ]
},
{
"name": "modemLockStatus",
"type": [
"null",
{
"name": "modemLockStatusEnum",
"type": "enum",
"symbols": [
"Unlocked",
"Locked"
]
}
]
},
{
"name": "commandsSent",
"type": [ "null", "double" ]
}
]
}
}
]
}
]
}
}
]
}
]
}
Následující tabulka obsahuje zdrojové zařízení/bod, možné hodnoty a definici každého bodu telemetrie.
| Bod telemetrie | Zdrojové zařízení nebo bod | Možné hodnoty | Definice |
|---|---|---|---|
| version | Ruční nastavení interně | Vydání verze telemetrie | |
| CONTACTID | Kontaktní zdroj | Identifikační číslo kontaktu | |
| contactPlatformIdentifier | Kontaktní zdroj | ||
| groundStationName | Kontaktní zdroj | Název uzemnění | |
| antennaType | Příslušní tvůrci telemetrie Microsoftu a partnerů nastavují tuto hodnotu. | MICROSOFT, KSAT, VIASAT | Anténní síť použitá pro kontakt. |
| antennaId | Kontaktní zdroj | Human-readable name of antenna ID | |
| spacecraftName | Parsováno z identifikátoru kontaktní platformy | Název vesmírné lodi | |
| gpsTime | Coversion of utcTime | Čas v čase GPS, kdy se vygenerovala zpráva telemetrie zákazníka. | |
| utcTime | Aktuální čas | Čas v čase UTC, kdy se vygenerovala zpráva telemetrie zákazníka. | |
| azimuthDecimalDegrees | ACU: AnténaAzimuth | Anténa je azimut v desítkových stupních. | |
| elevationDecimalDegrees | ACU: Anténa–levace | Anténa má výšku v desítkových stupních. | |
| contactTleLine1 | ACU: Satelitní[0]. Model.Value | Řetězec řádku TLE 1 | První řádek TLE použitý pro kontakt. |
| contactTLeLine2 | ACU: Satelitní[0]. Model.Value | Řetězec řádku TLE 2 | Druhý řádek TLE použitý pro kontakt. |
| name [Link-level] | Odkaz na profil kontaktu | Název odkazu | |
| směr | Odkaz na profil kontaktu | Uplink, Downlink | Směr odkazu použitého pro kontakt. |
| polarizace | Odkaz na profil kontaktu | RHCP, LHCP, DualRhcpLhcp, LinearVertical, LinearHorizontal | Polarizace odkazu použitého pro kontakt. |
| uplinkEnabled | ACU: SBandCurrent nebo UHFTotalCurrent | • NULL (Neplatný směr CenterFrequencyMhz nebo Downlink) • Nepravda (pásma jiná než S a UHF nebo aktuální < prahová hodnota proudu) • True (S/UHF-band, Uplink, Amp Current > Threshold) |
Určuje, jestli bylo pro kontakt povolené odesílání. |
| name [Channel-level] | Kanál odkazu na profil kontaktu | Název kanálu | |
| modemName | Modem | Název modemového zařízení | |
| digitizerName | Tablet | Název zařízení digitizátoru | |
| endpointName | Kanál odkazu na profil kontaktu | Název koncového bodu použitého pro kontakt. | |
| inputEbN0InDb | Modem: měřenoEbN0 | • NULL (model modemu jiný než QRadio nebo QRx) • Double: Vstup EbN0 |
Vstupní energie na bit do šumu spektrální hustota v dB. |
| inputEsN0InDb | Modem: měřenoEsN0 | • NULL (model modemu jiný než QRx) • Double: Vstup EsN0 |
Vstupní energie na symbol k šumu spektrální hustoty v dB. |
| inputRfPowerDbm | Digitizer: inputRfPower | • NULL (jiný ovladač pro odesílání nebo číslici než SNNB nebo SNWB) • Double: Vstupní rf napájení |
Vstupní rf výkon v dBm. |
| outputRfPowerDbm | Digitizer: outputRfPower | • NULL (jiný ovladač downlinku nebo digitizátoru než SNNB nebo SNWB) • Double: Výstupní rf výkon |
Výkon Ouput RF v dBm. |
| outputPacketRate | Digitizer: rfOutputStream[0].measuredPacketRate | • NULL (jiný ovladač downlinku nebo digitizátoru než SNNB nebo SNWB) • Double: Výstupní frekvence paketů |
Naměřená rychlost paketů pro odesílání |
| gapCount | Digitizer: rfOutputStream[0].gapCount | • NULL (jiný ovladač downlinku nebo digitizátoru než SNNB nebo SNWB) • Double: Počet mezer |
Počet mezer paketů pro odesílání |
| modemLockStatus | Modem: carrierLockState | • NULL (model modemu jiný než QRadio nebo QRx; nelze analyzovat stav zámku – výčet) • Prázdný řetězec (pokud čtení metriky má hodnotu null) • Řetězec: Stav zámku |
Potvrzení, že modem byl uzamčen. |
| commandsSent | Modem: commandsSent | • NULL (pokud není odchozí a QRadio) • Double: počet odeslaných příkazů |
Potvrzení odeslání příkazů během kontaktu |
Příjemci událostí
Pomocí příjemců událostí můžete psát jednoduché uživatelské aplikace pro příjem událostí ze služby Event Hubs. V následující dokumentaci se dozvíte, jak odesílat a přijímat události Event Hubs v různých jazycích:
Protokol změn
2024-04-17 - Aktualizované schéma tak, aby zahrnovalo možnou hodnotu NULL pro TLEs, a přidali esN0 pro QRX a přidali blurb o tom, jak antény Microsoftu mohou mít hodnotu NULL pro pole během první sekundy kontaktu.
2023-10-03 - Zavedení verze 4.0. Aktualizované schéma tak, aby zahrnovalo metriky paketů pro odesílání a názvy používané infrastruktury (pozemní stanice, anténa, vesmírná loď, modem, digitizátor, propojení, kanál)
2023-06-05 - Aktualizované schéma zobrazte metriky v kanálech místo odkazů.