Sensorintegrering som både partner och kund i Azure Data Manager for Agriculture

Artikel
10/26/2023

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-06-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-06-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.

Dela via