Realtime antennetelemetrie ontvangen
Azure Orbital Ground station verzendt antennetelemetrie-gebeurtenissen die kunnen worden gebruikt om de werking van het grondstation tijdens een contact te analyseren. U kunt uw profiel voor contactpersonen configureren om telemetrie-gebeurtenissen naar Azure Event Hubs te verzenden.
In deze handleiding leert u het volgende:
- Azure Event Hubs configureren voor Azure Orbital Ground Station
- Schakel telemetrie in uw profiel voor contactpersonen in.
- Inhoud van telemetriegegevens controleren
- Telemetriepunten begrijpen
Event Hubs configureren
- Ga in uw abonnement naar resourceproviders in instellingen. Zoek naar Microsoft.Orbital en registreer deze als provider.
- Maak een Azure Event Hubs-naamruimte en een Event Hub in uw abonnement.
Notitie
Kies Openbare toegang voor connectiviteitstoegang tot eventhubs. Privétoegang of service-eindpunten worden niet ondersteund.
- Selecteer toegangsbeheer (IAM) in het linkermenu. Selecteer onder Toegang verlenen tot deze resource de optie Roltoewijzing toevoegen.
Notitie
Als u Azure-rollen wilt toewijzen, moet u beschikken over: Microsoft.Authorization/roleAssignments/write machtigingen, zoals gebruikerstoegang Beheer istrator of eigenaar
- Zoek en selecteer op het tabblad Rol de gegevenszender van Azure Event Hubs. Klik op Volgende.
- Wijs op het tabblad Leden toegang toe aan gebruiker, groep of service-principal.
- Klik op + Leden selecteren.
- Zoek naar Azure Orbital-resourceprovider en klik op Selecteren.
- Klik op Controleren en toewijzen. Met deze actie verleent Azure Orbital Ground Station de rechten om telemetrie naar uw Event Hub te verzenden.
- Als u de zojuist toegevoegde roltoewijzing wilt bevestigen, gaat u terug naar de pagina Toegangsbeheer (IAM) en selecteert u Toegang tot deze resource weergeven. Azure Orbital-resourceprovider moet zich onder Azure Event Hubs-gegevenszender bevinden.
Event Hubs-telemetrie inschakelen voor een contactprofiel
Configureer als volgt een profiel voor contactpersonen:
- Kies een naamruimte met behulp van de vervolgkeuzelijst Event Hubs-naamruimte.
- Kies een exemplaar met behulp van de vervolgkeuzelijst Event Hubs Instance die wordt weergegeven na de selectie van de naamruimte.
U kunt de instellingen van een bestaand profiel voor contactpersonen bijwerken door
Telemetriegegevens van antennes van een contactpersoon controleren
Plan contactpersonen met behulp van het contactprofiel dat u eerder hebt geconfigureerd voor Event Hubs-telemetrie. Zodra een contactpersoon begint, moet u snel daarna gegevens in uw Event Hubs zien.
U kunt zowel de aanwezigheid als de inhoud van binnenkomende telemetriegegevens op meerdere manieren controleren.
Event Hubs-naamruimtedashboard
Als u wilt controleren of gebeurtenissen worden ontvangen in uw Event Hubs, kunt u de grafieken controleren die aanwezig zijn op de overzichtspagina van uw Event Hubs-naamruimte binnen uw resourcegroep. In deze weergave worden gegevens weergegeven in alle Event Hubs-exemplaren binnen een naamruimte. U kunt naar de overzichtspagina van een specifiek Event Hub-exemplaar in uw resourcegroep navigeren om de grafieken voor dat exemplaar te bekijken.
Telemetriegegevens van antennes leveren aan een opslagaccount
U kunt de functie Event Hubs Capture inschakelen om de telemetriegegevens automatisch te leveren aan een Azure Blob Storage-account van uw keuze. Volg de instructies om Capture en capture-gegevens in te schakelen in Azure Storage. Zodra deze optie is ingeschakeld, kunt u uw container controleren en de gegevens bekijken/downloaden.
Telemetriepunten begrijpen
Huidige versie van het telemetrieschema: 4.1
Het grondstation biedt telemetrie met behulp van Avro als schema. Het schema is hieronder. Opmerking: Microsoft-antennes verzenden Telemetrie zodra het eerste gegevenspunt is ontvangen. Telemetrie wordt gerapporteerd met behulp van een 'laatst bekende waarde'-benadering, wat betekent dat we altijd de meest recente waarde verzenden die we hebben voor een metrische waarde. Vanwege dit gedrag ziet u mogelijk een NULL waarde in de eerste seconde van een contactpersoon totdat die metrische waarde voor het eerst wordt geproduceerd.
{
"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" ]
}
]
}
}
]
}
]
}
}
]
}
]
}
De volgende tabel bevat het bronapparaat/punt, mogelijke waarden en de definitie van elk telemetriepunt.
| Telemetriepunt | Bronapparaat/-punt | Mogelijke waarden | Definitie |
|---|---|---|---|
| version | Intern handmatig instellen | Releaseversie van de telemetrie | |
| contactID | Contact opnemen met resource | Identificatienummer van de contactpersoon | |
| contactPlatformIdentifier | Contact opnemen met resource | ||
| groundStationName | Contact opnemen met resource | Naam van grondstation | |
| antenneType | Respectieve Microsoft/partnertelemetriebouwers stellen deze waarde in | MICROSOFT, KSAT, VIASAT | Antennenetwerk gebruikt voor het contact. |
| antenneId | Contact opnemen met resource | Leesbare naam van antenne-id | |
| spacecraftName | Geparseerd vanuit platform-id van contactpersoon | Naam van ruimtevaartuig | |
| gpsTime | Dekking van utcTime | Tijd in GPS-tijd dat het telemetriebericht van de klant is gegenereerd. | |
| utcTime | Huidige tijd | Tijd in UTC-tijd dat het telemetriebericht van de klant is gegenereerd. | |
| azimuthDecimalDegrees | ACU: AntenneAzimuth | Antenne is azimuth in decimale graden. | |
| elevationDecimalDegrees | ACU: Antenne-levatie | De hoogte van antennes in decimale graden. | |
| contactTleLine1 | ACU: Satelliet[0]. Model.Value | Tekenreeks van TLE-regel 1 | Eerste regel van de TLE die voor de contactpersoon wordt gebruikt. |
| contactTLeLine2 | ACU: Satelliet[0]. Model.Value | Tekenreeks van TLE-lijn 2 | Tweede regel van de TLE die voor de contactpersoon wordt gebruikt. |
| name [Niveau van koppeling] | Koppeling naar profiel van contactpersoon | Naam van de koppeling | |
| richting | Koppeling naar profiel van contactpersoon | Uplink, Downlink | Richting van de koppeling die wordt gebruikt voor de contactpersoon. |
| Polarisatie | Koppeling naar profiel van contactpersoon | RHCP, LHCP, DualRhcpLhcp, LinearVertical, LinearHorizontal | Polarisatie van de koppeling die wordt gebruikt voor de contactpersoon. |
| uplinkEnabled | ACU: SBandCurrent of UHFTotalCurrent | • NULL (ongeldige richting CenterFrequencyMhz of Downlink) • Onwaar (andere banden dan S- en UHF- of amp-huidige < drempelwaarde) • Waar (S/UHF-band, Uplink, Amp Current > Threshold) |
Geeft aan of uplink is ingeschakeld voor de contactpersoon. |
| name [Kanaalniveau] | Kanaal voor koppeling van contactprofiel | Naam van het kanaal | |
| modemNaam | Modem | Naam van modemapparaat | |
| digitalerName | Digitizer | Naam van digitaliserend apparaat | |
| endpointName | Kanaal voor koppeling van contactprofiel | Naam van het eindpunt dat wordt gebruikt voor de contactpersoon. | |
| inputEbN0InDb | Modem: measuredEbN0 | • NULL (modemmodel anders dan QRadio of QRx) • Dubbel: Invoer EbN0 |
Input energy per bit to noise power spectral density in dB. |
| inputEsN0InDb | Modem: measuredEsN0 | • NULL (modemmodel anders dan QRx) • Dubbel: Invoer EsN0 |
Invoer-energie per symbool voor ruisstroomdichtheid in dB. |
| inputRfPowerDbm | Digitaliserende functie: inputRfPower | • NULL (uplink- of digitalisatiestuurprogramma anders dan SNNB of SNWB) • Dubbel: Invoer rf vermogen |
Rf-invoerstroom in dBm. |
| outputRfPowerDbm | Digitaliseren: outputRfPower | • NULL (Downlink of Digitaler driver anders dan SNNB of SNWB) • Dubbel: Output Rf Vermogen |
Oeput RF-vermogen in dBm. |
| outputPacketRate | Digitaler: rfOutputStream[0].measuredPacketRate | • NULL (Downlink of Digitaler driver anders dan SNNB of SNWB) • Dubbel: uitvoerpakketsnelheid |
Gemeten pakketsnelheid voor Uplink |
| gapCount | Digitaliseren: rfOutputStream[0].gapCount | • NULL (Downlink of Digitaler driver anders dan SNNB of SNWB) • Dubbel: Aantal tussenruimtes |
Aantal pakketten voor Uplink |
| modemLockStatus | Modem: carrierLockState | • NULL (modemmodel anders dan QRadio of QRx; kan de vergrendelingsstatus enum niet parseren) • Lege tekenreeks (als metrische waarde null was) • Tekenreeks: Vergrendelingsstatus |
Bevestiging dat de modem is vergrendeld. |
| opdrachtenSent | Modem: opdrachtenSent | • NULL (indien niet Uplink en QRadio) • Dubbel: aantal opdrachten verzonden |
Bevestiging dat opdrachten zijn verzonden tijdens de contactpersoon. |
Gebeurtenisconsumers
U kunt eenvoudige consumenten-apps schrijven om gebeurtenissen van uw Event Hubs te ontvangen met behulp van gebeurtenisgebruikers. Raadpleeg de volgende documentatie voor meer informatie over het verzenden en ontvangen van event Hubs in verschillende talen:
Wijzigingenlogboek
2024-04-17 - Bijgewerkt schema met mogelijke NULL voor TLE's, en EsN0 toegevoegd voor QRX, en blurb toegevoegd over hoe Microsoft-antennes een NULL voor een veld kunnen hebben tijdens de eerste seconde van een contact.
2023-10-03 - Introduceer versie 4.0. Bijgewerkt schema voor het opnemen van metrische gegevens van uplinkpakketten en namen van infrastructuur die in gebruik zijn (grondstation, antenne, ruimtevaartuig, modem, digitalisatie, koppeling, kanaal)
2023-06-05 - Bijgewerkt schema om metrische gegevens onder kanalen weer te geven in plaats van koppelingen.
Volgende stappen
Feedback
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor