Valós idejű antennatelemetria fogadása
Az Azure Orbital Ground állomás olyan antenna telemetriai eseményeket bocsát ki, amelyek a földi állomás kapcsolat közbeni működésének elemzésére használhatók. Konfigurálhatja a partnerprofilt, hogy telemetriai eseményeket küldjön az Azure Event Hubsnak.
Az útmutató segítségével megtanulhatja a következőket:
- Az Azure Event Hubs konfigurálása az Azure Orbital Ground Stationhez
- Telemetria engedélyezése a partnerprofilban.
- Telemetriaadatok tartalmának ellenőrzése
- A telemetriai pontok ismertetése
Event Hubs konfigurálása
- Az előfizetésben lépjen az erőforrás-szolgáltatókhoz a beállítások között. Keresse meg a Microsoft.Orbitalt , és regisztrálja szolgáltatóként.
- Hozzon létre egy Azure Event Hubs-névteret és egy eseményközpontot az előfizetésében.
Feljegyzés
Válassza a nyilvános hozzáférést az EventHubshoz való kapcsolódáshoz. A privát hozzáférés vagy szolgáltatásvégpontok nem támogatottak.
- A bal oldali menüben válassza a Hozzáférés-vezérlés (IAM) lehetőséget. Az erőforráshoz való hozzáférés biztosítása csoportban válassza a Szerepkör-hozzárendelés hozzáadása lehetőséget.
Feljegyzés
Az Azure-szerepkörök hozzárendeléséhez a következő engedélyekkel kell rendelkeznie, Microsoft.Authorization/roleAssignments/write
mint például a Felhasználói hozzáférés Rendszergazda istrator vagy a Tulajdonos
- A Szerepkör lapon keresse meg és válassza ki az Azure Event Hubs-adatküldőt. Kattintson a Tovább gombra.
- A Tagok lapon rendeljen hozzá hozzáférést a Felhasználóhoz, csoporthoz vagy szolgáltatásnévhez.
- Kattintson a + Tagok kijelölése elemre.
- Keresse meg az Azure Orbital-erőforrás-szolgáltatót, és kattintson a Kiválasztás gombra.
- Kattintson a Véleményezés + hozzárendelés gombra. Ez a művelet biztosítja az Azure Orbital Ground Station számára a telemetriai adatok eseményközpontba való küldéséhez szükséges jogosultságokat.
- Az újonnan hozzáadott szerepkör-hozzárendelés megerősítéséhez lépjen vissza a Hozzáférés-vezérlés (IAM) lapra, és válassza az Erőforrás hozzáférésének megtekintése lehetőséget. Az Azure Orbital-erőforrás-szolgáltatónak az Azure Event Hubs adatküldője alatt kell lennie.
Event Hubs-telemetriai adatok engedélyezése névjegyprofilhoz
Konfiguráljon egy partnerprofilt az alábbiak szerint:
- Válasszon egy névteret az Event Hubs Névtér legördülő listából.
- Válasszon ki egy példányt a névtér kiválasztása után megjelenő Event Hubs-példány legördülő listából.
Meglévő partnerprofil beállításait a következővel frissítheti:
Az antenna telemetriai adatainak ellenőrzése egy partnertől
Ütemezze a névjegyeket az Event Hubs-telemetriához korábban konfigurált partnerprofil használatával. Miután egy partner megkezdődik, nem sokkal később meg kell kezdenie az adatok megtekintését az Event Hubsban.
A bejövő telemetriai adatok jelenlétét és tartalmát többféleképpen is ellenőrizheti.
Event Hubs-névtér irányítópultja
Annak ellenőrzéséhez, hogy az eseményközpontokban események érkeznek-e, ellenőrizheti az Event Hubs-névtér áttekintési oldalán található grafikonokat az erőforráscsoporton belül. Ez a nézet egy névtérben lévő összes Event Hubs-példány adatait jeleníti meg. Az erőforráscsoport egy adott Event Hub-példányának áttekintési lapjára lépve megtekintheti az adott példány gráfjait.
Antennatelemetriaadatok kézbesítése tárfiókba
Engedélyezheti, hogy az Event Hubs Capture szolgáltatás automatikusan kézbesítse a telemetriai adatokat egy ön által választott Azure Blob Storage-fiókba. Az utasításokat követve engedélyezheti az adatok rögzítését és rögzítését az Azure Storage-ban. Ha engedélyezve van, ellenőrizheti a tárolót, és megtekintheti/letöltheti az adatokat.
A telemetriai pontok ismertetése
A telemetria jelenlegi sémaverziója: 4.1
A földi állomás az Avro-t sémaként használó telemetriát biztosít. A séma alább látható. Vegye figyelembe, hogy a Microsoft antennái telemetriát bocsátanak ki az első adatpont beérkezése után. A telemetria jelentése "utolsó ismert érték" megközelítéssel történik, ami azt jelenti, hogy mindig a metrika legfrissebb értékét küldjük el. Ennek a viselkedésnek köszönhetően előfordulhat, hogy a partner első másodpercében megjelenik egy NULL
érték, amíg a metrika először létre nem jön.
{
"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" ]
}
]
}
}
]
}
]
}
}
]
}
]
}
Az alábbi táblázat az egyes telemetriai pontok forráseszközét/pontját, lehetséges értékeit és definícióját tartalmazza.
Telemetriai pont | Forráseszköz/pont | Lehetséges értékek | Definíció |
---|---|---|---|
Verzió | Manuális beállítás belsőleg | A telemetria kiadási verziója | |
contactID | Kapcsolatfelvételi erőforrás | A kapcsolattartó azonosítószáma | |
contactPlatformIdentifier | Kapcsolatfelvételi erőforrás | ||
groundStationName | Kapcsolatfelvételi erőforrás | A földi állomás neve | |
antennaType | Ezt az értéket a Microsoft/partner telemetriai készítői állítják be | MICROSOFT, KSAT, VIASAT | A kapcsolathoz használt antennahálózat. |
antennaId | Kapcsolatfelvételi erőforrás | Az antennaazonosító olvasható neve | |
spacecraftName | Elemzés a kapcsolatplatform-azonosítóból | Űrhajó neve | |
gpsTime | Az utcTime fedőlapja | Az ügyfél telemetriai üzenetének generálása GPS-idő alatt. | |
utcTime | Aktuális idő | Az ügyfél telemetriai üzenetének létrehozása UTC-ben megadott időpontban. | |
azimuthDecimalDegrees | ACU: AntennaAzimuth | Antenna azimuth decimális fokban. | |
elevationDecimalDegrees | ACU: AntennaElevation | Az antenna szintemelkedése decimális fokban. | |
contactTleLine1 | ACU: Műhold[0]. Model.Value | 1. TLE-sor sztringje | A partnerhez használt TLE első sora. |
contactTLeLine2 | ACU: Műhold[0]. Model.Value | 2. TLE-sor sztringje | A partnerhez használt TLE második sora. |
name [Link-level] | Partnerprofil hivatkozása | A hivatkozás neve | |
irány | Partnerprofil hivatkozása | Uplink, Downlink | A partnerhez használt hivatkozás iránya. |
Polarizáció | Partnerprofil hivatkozása | RHCP, LHCP, DualRhcpLhcp, LinearVertical, LinearHorizontal | A kapcsolathoz használt hivatkozás polarizációja. |
uplinkEnabled | ACU: SBandCurrent vagy UHFTotalCurrent | • NULL (Érvénytelen CenterFrequencyMhz vagy Downlink irány) • Hamis (S és UHF vagy amp aktuális < küszöbérték kivételével sávok) • Igaz (S/UHF-sáv, uplink, amp current > threshold) |
Azt jelzi, hogy engedélyezve volt-e a kapcsolatfelvétel a partner számára. |
name [Channel-level] | Partnerprofil hivatkozási csatornája | A csatorna neve | |
modemName | Modem | A modemeszköz neve | |
digitizerName | Digitalizáló | A digitalizáló eszköz neve | |
endpointName | Partnerprofil hivatkozási csatornája | A partnerhez használt végpont neve. | |
inputEbN0InDb | Modem: measuredEbN0 | • NULL (A modem modellje nem QRadio vagy QRx) • Dupla: Bemeneti EbN0 |
Bemeneti energia bitenként a zajteljesítmény spektrális sűrűségéhez dB-ben. |
inputEsN0InDb | Modem: measuredEsN0 | • NULL (A modem modellje nem QRx) • Dupla: Bemeneti EsN0 |
Jelenkénti bemeneti energia a zajteljesítmény spektrális sűrűségéhez dB-ben. |
inputRfPowerDbm | Digitalizáló: inputRfPower | • NULL (kimenő vagy digitalizáló illesztő, nem SNNB vagy SNWB) • Dupla: Bemeneti rf power |
Bemeneti RF-teljesítmény a dBm-ben. |
outputRfPowerDbm | Digitalizáló: outputRfPower | • NULL (Lemenő vagy digitalizáló illesztő, nem SNNB vagy SNWB) • Dupla: Kimeneti rf power |
Ouput RF teljesítmény dBm-ben. |
outputPacketRate | Digitalizáló: rfOutputStream[0].measuredPacketRate | • NULL (Lemenő vagy digitalizáló illesztő, nem SNNB vagy SNWB) • Dupla: Kimeneti csomagsebesség |
Az Uplink mért csomagsebessége |
gapCount | Digitalizáló: rfOutputStream[0].gapCount | • NULL (Lemenő vagy digitalizáló illesztő, nem SNNB vagy SNWB) • Dupla: Rések száma |
Csomagrések száma uplink esetén |
modemLockStatus | Modem: carrierLockState | • NULL (A modem modellje nem QRadio vagy QRx; nem tudta elemezni az Enum zárolási állapotát) • Üres sztring (ha a metrikaolvasás null értékű volt) • Sztring: Zárolás állapota |
Annak megerősítése, hogy a modem zárolva volt. |
commandsSent | Modem: commandsSent | • NULL (ha nem Uplink és QRadio) • Dupla: az elküldött parancsok száma |
Annak megerősítése, hogy a parancsok a névjegy során lettek elküldve. |
Eseményfelhasználók
Egyszerű fogyasztói alkalmazásokat írhat, hogy eseményeket fogadjon az Event Hubsból az eseményfelhasználók használatával. Az eseményközpontok különböző nyelveken történő küldéséhez és fogadásához tekintse meg az alábbi dokumentációt:
Változásnapló
2024-04-17 – Frissített séma, amely tartalmazza a TLE-k lehetséges NULL értékét, és hozzáadta a QRX-hez tartozó EsN0-t, és elhomályosítja, hogy a Microsoft-antennák hogyan rendelkezhetnek NULL értékkel egy mezőhöz a névjegy első másodpercében.
2023-10-03 – A 4.0-s verzió bevezetése. Frissített séma, amely tartalmazza a kimenő csomagok metrikáit és a használatban lévő infrastruktúra nevét (földi állomás, antenna, űrhajó, modem, digitalizáló, link, csatorna)
2023-06-05 – Frissített séma, amely hivatkozások helyett csatornákon jeleníti meg a metrikákat.