Sensorintegrering som både partner och kund i Azure Data Manager for Agriculture
Följ stegen nedan för att registrera dig som sensorpartner så att du kan börja skicka dina data till din Data Manager for Agriculture-instans.
Steg 1: Aktivera sensorintegrering
- Sensorintegrering bör aktiveras innan den kan initieras. Det här steget etablerar nödvändiga interna Azure-resurser för sensorintegrering för Data Manager for Agriculture-instansen. Detta kan göras genom att köra följande armclient-kommando .
armclient patch /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.AgFoodPlatform/farmBeats/<datamanager-instance-name>?api-version=2023-04-01-preview "{properties:{sensorIntegration:{enabled:'true'}}}"
Exempel på utdata:
{
"id": "/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.AgFoodPlatform/farmBeats/<datamanager-instance-name>",
"type": "Microsoft.AgFoodPlatform/farmBeats",
"sku": {
"name": "A0"
},
"systemData": {
"createdBy": "<customer-id>",
"createdByType": "User",
"createdAt": "2022-03-11T03:36:32Z",
"lastModifiedBy": "<customer-id>",
"lastModifiedByType": "User",
"lastModifiedAt": "2022-03-11T03:40:06Z"
},
"properties": {
"instanceUri": "https://<datamanager-instance-name>.farmbeats.azure.net/",
"provisioningState": "Succeeded",
"sensorIntegration": {
"enabled": "True",
"provisioningState": "**Creating**"
},
"publicNetworkAccess": "Enabled"
},
"location": "eastus",
"name": "myfarmbeats"
}
- Jobbet ovan kan ta några minuter att slutföra. För att känna till status för jobbet ska följande armclient-kommando köras:
armclient get /subscriptions/<subscription-id>/resourceGroups/<resource-group-name> /providers/Microsoft.AgFoodPlatform/farmBeats/<datamanager-instance-name>?api-version=2023-04-01-preview
- Kontrollera om det har slutförts genom att titta på det markerade attributet. Den bör uppdateras som "Lyckades" från "Skapa" i det tidigare steget. Attributet som anger att sensorintegreringen är aktiverad indikeras av provisioningState inuti sensorIntegration-objektet.
Exempel på utdata:
{
"id": "/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.AgFoodPlatform/farmBeats/<datamanager-instance-name>",
"type": "Microsoft.AgFoodPlatform/farmBeats",
"sku": {
"name": "A0"
},
"systemData": {
"createdBy": "<customer-id>",
"createdByType": "User",
"createdAt": "2022-03-11T03:36:32Z",
"lastModifiedBy": "<customer-id>",
"lastModifiedByType": "User",
"lastModifiedAt": "2022-03-11T03:40:06Z"
},
"properties": {
"instanceUri": "https://<customer-host-name>.farmbeats.azure.net/",
"provisioningState": "Succeeded",
"sensorIntegration": {
"enabled": "True",
"provisioningState": "**Succeeded**"
},
"publicNetworkAccess": "Enabled"
},
"tags": {
"usage": "<sensor-partner-id>"
},
"location": "eastus",
"name": "<customer-id>"
}
När etableringsstatusen för sensorintegrering har slutförts kan sensorintegreringsobjekt skapas.
Steg 2: Skapa integrering av sensorpartner
Integrationssteget skapa sensorpartner ska köras för att ansluta kunden till providern. IntegrationId används senare när sensorn skapas.
API-dokumentation: Sensorpartnerintegreringar – Skapa eller uppdatera
Steg 3: Skapa sensordatamodell
Använd sensordatamodellen för att definiera modellen för telemetri som skickas. All telemetri som skickas av sensorn verifieras enligt den här datamodellen.
API-dokumentation: Sensordatamodeller – Skapa eller uppdatera
Exempeltelemetri
{
"pressure": 30.45,
"temperature": 28,
"name": "sensor-1"
}
Motsvarande sensordatamodell
{
"type": "Sensor",
"manufacturer": "Some sensor manufacturer",
"productCode": "soil m",
"measures": {
"pressure": {
"description": "measures soil moisture",
"dataType": "Double",
"type": "sm",
"unit": "Bar",
"properties": {
"abc": "def",
"elevation": 5
}
},
"temperature": {
"description": "measures soil temperature",
"dataType": "Long",
"type": "sm",
"unit": "Celsius",
"properties": {
"abc": "def",
"elevation": 5
}
},
"name": {
"description": "Sensor name",
"dataType": "String",
"type": "sm",
"unit": "none",
"properties": {
"abc": "def",
"elevation": 5
}
}
},
"sensorPartnerId": "sensor-partner-1",
"id": "sdm124",
"status": "new",
"createdDateTime": "2022-01-24T06:12:15Z",
"modifiedDateTime": "2022-01-24T06:12:15Z",
"eTag": "040158a0-0000-0700-0000-61ee433f0000",
"name": "my sdm for soil moisture",
"description": "description goes here",
"properties": {
"key1": "value1",
"key2": 123.45
}
}
Steg 4: Skapa sensor
Skapa sensor med motsvarande integrations-ID och sensordatamodell-ID. DeviceId och HardwareId är valfria parametrar, om det behövs kan du använda Enheter – Skapa eller uppdatera för att skapa enheten.
API-dokumentation: Sensorer – Skapa eller uppdatera
Steg 5: Hämta IoTHub-anslutningssträng
Hämta IoTHub-anslutningssträng för att skicka sensortelemetri till plattformen för sensorn som skapats.
API-dokumentation: Sensorer – Hämta Anslut ionssträng
Steg 6: Skicka data med IoT Hub
Använd IoT Hub Device SDK:er för att push-överföra telemetrin med hjälp av anslutningssträng.
För alla sensortelemetrihändelser är "tidsstämpel" en obligatorisk egenskap och måste vara i ISO 8601-format (ÅÅÅÅ-MM-DDTHH:MM:SSZ).
Nu är du redo att börja skicka sensordata för alla sensorer med respektive anslutningssträng som tillhandahålls för varje sensor. Sensordata bör dock skickas i det format som definierats i sensordatamodellen som skapades i steg 3. Se ett exempel på telemetrischemat som följer:
{
"timestamp": "2022-02-11T03:15:00Z",
"bar": 30.181,
"bar_absolute": 29.748,
"bar_trend": 0,
"et_day": 0.081,
"humidity": 55,
"rain_15_min": 0,
"rain_60_min": 0,
"rain_24_hr": 0,
"rain_day": 0,
"rain_rate": 0,
"rain_storm": 0,
"solar_rad": 0,
"temp_out": 58.8,
"uv_index": 0,
"wind_dir": 131,
"wind_dir_of_gust_10_min": 134,
"wind_gust_10_min": 0,
"wind_speed": 0,
"wind_speed_2_min": 0,
"wind_speed_10_min": 0
}
Nästa steg
- Testa våra API:er här.