Övning – Skapa ett Azure IoT Central-program

  • 8 minuter

Skapa ett Azure IoT Central-program för dina IoT Edge-enheter att ansluta till och hanteras från.

Kom ihåg att du planerar att distribuera en IoT Edge-enhet i varje lager för att hantera de lokala sensorerna och filtrera de data som skickas till Azure IoT Central.

Här använder du Azure CLI för att skapa ett Azure IoT Central-program från den anpassade programmallen . Du kör CLI-kommandona i Azure-sandbox-miljön och går sedan till programmets webbgränssnitt. I webbgränssnittet slutför du installationen genom att lägga till en enhetsmall för din IoT Edge-enhet.

Kommentar

Den här övningen är valfri. Om du vill slutföra den här övningen måste du skapa en Azure-prenumeration innan du börjar. Om du inte har något Azure-konto eller om du inte vill skapa ett för tillfället kan du läsa igenom anvisningarna så att du förstår den information som visas.

Ladda ned distributionsmanifestet

När du skapar enhetsmallen för din IoT Edge-enhet behöver du distributionsmanifestet och en gränssnittsdefinition på den lokala datorn. Om du vill ladda ned dessa filer högerklickar du på de här länkarna och väljer Spara som:

Kom ihåg var du sparar de här filerna, du behöver dem för senare.

Skapa och konfigurera Azure IoT Central-programmet

Följande steg skapar ett Azure IoT Central-program och genererar en API-token som ska användas senare i den här modulen.

  1. Kör följande kommandon i Azure Cloud Shell för att generera ett unikt namn för ditt Azure IoT Central-program och spara det i en miljövariabel som ska användas senare:

    APP_NAME="store-manager-$RANDOM"
echo "Your application name is: $APP_NAME"

    Anteckna programnamnet ändå, om skalet skulle överskrida en tidsgräns så att miljövariabeln går förlorad.

  2. Om du vill skapa ett Azure IoT Central-program i sandbox-miljön kör du följande kommando i Cloud Shell:

    az iot central app create \
--resource-group <rgn>[sandbox resource group name]</rgn> \
--name $APP_NAME --sku ST2 --location centralus \
--subdomain $APP_NAME --template iotc-pnp-preview \
--display-name 'Store Management'
echo "You can now navigate to: https://$APP_NAME.azureiotcentral.com/edge-manifests"

    Det kan ta några minuter att köra kommandot.

  3. I en annan webbläsarflik eller ett annat fönster går du till den URL som visas i utdata från föregående kommando. På den här sidan för webbgränssnittet laddar du upp ett IoT Edge-distributionsmanifest:

    Skärmbild som visar sidan med distributionsmanifest där du hanterar IoT Edge-distributionsmanifesten i ditt Azure IoT Central-program.

  4. Välj Skapa ett kantmanifest, ange namnet Miljösensor, välj Ladda upp en fil och bläddra sedan för att välja den EnvironmentalSensorManifest-1-4.json fil som du laddade ned tidigare.

  5. Välj Nästa och sedan Skapa för att ladda upp manifestet. Manifestet konfigurerar tre IoT Edge-moduler: edgeAgent, edgeHub och SimulatedTemperatureSensor.

  6. Välj sedan Enhetsmallar. På den här sidan för webbgränssnittet skapar du en enhetsmall:

    Skärmbild som visar sidan med enhetsmallar där du hanterar mallarna i ditt Azure IoT Central-program.

  7. Välj Skapa en enhetsmall, välj Azure IoT Edge-panelen och välj sedan Nästa: Anpassa.

  8. Ange Miljösensor edge-enhet som namnet på enhetsmallen. Välj sedan Nästa: Granska.

  9. Välj Skapa för att skapa enhetsmallen. Välj sedan Anpassad modell för att börja med en tom modell.

Distributionsmanifestet som du laddade upp har en modul med namnet SimulatedTemperatureSensor med ett gränssnitt som kallas hantering. Hanteringsgränssnittet innehåller de skrivbara egenskaperna SendData och SendInterval. Följ dessa steg för att lägga till den här informationen i den nya enhetsmallen:

  1. På sidan enhetsmall väljer du Moduler i avsnittet Modell .

  2. Välj Importera moduler från manifestet:

    Skärmbild som visar sidan med enhetsmallar där du importerar moduldefinitionerna från distributionsmanifestet.

  3. Välj distributionsmanifestet för miljösensorer för att importera modulerna.

Enhetsmallen innehåller nu modulen SimulatedTemperatureSensor med ett hanteringsgränssnitt . Gränssnittet definierar de skrivbara egenskaperna SendData och SendInterval .

Distributionsmanifestet innehåller inte information om telemetrin som enhetsmodulerna skickar. Om du vill göra det möjligt för Azure IoT Central att skapa visualiseringar för telemetrin lägger du till ett gränssnitt med de definitioner som krävs:

  1. Välj modulen SimulatedTemperatureSensor och välj sedan + Lägg till ärvt gränssnitt. Du kan behöva välja ellipsknappen (...) för att se det här alternativet.

  2. Välj panelen Importera gränssnitt och välj den TelemetryInterface.json fil som du laddade ned tidigare.

    Telemetrigränssnittet definierar maskin- och omgivande telemetrityper som objekt. Maskinobjektet innehåller temperatur- och trycktelemetri. Det omgivande objektet innehåller telemetri för temperatur och luftfuktighet. Gränssnittet innehåller även tidSkapad som en DateTime-telemetrityp .

    Skärmbild som visar telemetrigränssnittet i enhetsmallen.

Om du vill göra det möjligt för en operatör att registrera information om varje IoT Edge-enhet lägger du till följande molnegenskaper i miljösensor edge-enhetsmodellen:

Visningsnamn Name Typ av kapacitet Schema
Butiksnamn StoreName Property String
Servicedatum ServiceDate Property Datum

Skärmbild som visar molnegenskaperna i enhetsmallen.

Dricks

Du måste expandera molnegenskapen för att se schemainställningen.

Välj Spara för att spara ändringarna.

Om du vill göra det möjligt för en operatör att visa miljödata från dina butiker lägger du till följande vy i enhetsmallen:

  1. Om du vill lägga till en ny vy väljer du Vyer i enhetsmallen. Välj sedan panelen Visualisera enheten .

    Skärmbild som visar panelen Visualisera enheten i enhetsmallen.

  2. Ändra namnet på vyn till Visa IoT Edge-enhetstelemetri.

  3. Välj Börja med enheter.

  4. Lägg till telemetrityperna ambient/temperature, humidity, machine/temperature och pressure och välj sedan Lägg till panel.

  5. Välj Spara.

    Skärmbild som visar telemetrivyns definition.

Om du vill att operatorn ska kunna registrera information om varje arkiv och hantera enheten lägger du till följande vy i enhetsmallen:

  1. Om du vill lägga till en ny vy väljer du Vyer i enhetsmallen. Välj sedan panelen Redigera enhet och molndata .

  2. Ändra formulärnamnet till Lagra information.

  3. Välj molnegenskaperna Butiksnamn och Tjänstdatum . Välj sedan Lägg till avsnitt.

  4. Välj Spara.

    Skärmbild som visar formulärdefinitionen för molnegenskap.

Nu är du redo att publicera mallen och lägga till en enhet:

  1. Längst upp på sidan väljer du Publicera och i dialogrutan Publicera den här enhetsmallen i programdialogrutan väljer du Publicera.

  2. Gå till sidan Enheter i ditt Azure IoT Central-program.

  3. Välj enhetsmallen Environmental Sensor Edge och välj sedan + Ny.

  4. I dialogrutan Skapa en ny enhet anger du store-001 som enhets-ID. Kontrollera att enhetsmallen är Miljösensor Edge-enhet och att Azure IoT Edge-enheten redan är inställd på Ja. Välj sedan Miljösensor som gränsmanifest. Välj Skapa.

Store-001-enheten visas i listan över enheter med statusen Registrerad.

Skärmbild som visar den registrerade enheten i enhetslistan.

Kontrollera ditt arbete

  1. I listan över enheter väljer du enhetsnamnet Environmental Sensor Edge Device – store-001. Du kan se tillgängliga vyer för enheten, inklusive Lagra information och Visa telemetri för IoT Edge-enheter.

  2. Välj Anslut längst upp på sidan. Anteckna ID-omfånget och primärnyckeln. Du använder dessa värden senare för att konfigurera din IoT Edge-enhet för att ansluta till ditt program.

    Håll den här sidan öppen i webbläsaren. Du återgår till det här Azure IoT Central-programmet senare.

Du har skapat ett program för att hantera dina butiker. Du har skapat en enhetsmall som innehåller ett IoT Edge-distributionsmanifest för de enheter som du planerar att installera i dina butiker. Mallen innehåller vyer som gör det möjligt för en operatör att övervaka miljöförhållandena i arkivet och fjärrhantera enheterna.