Snabb start: lägga till en simulerad enhet till ditt IoT Central programQuickstart: Add a simulated device to your IoT Central application

Den här artikeln gäller för operatörer, kompilerare och administratörer.This article applies to operators, builders, and administrators.

En enhets mall definierar funktionerna hos en enhet som ansluter till ditt IoT Central-program.A device template defines the capabilities of a device that connects to your IoT Central application. Funktionerna omfattar telemetri som enheten skickar, enhets egenskaper och de kommandon som en enhet svarar på.Capabilities include telemetry the device sends, device properties, and the commands a device responds to. Från en enhets mall kan ett verktyg eller en operatör lägga till både riktiga och simulerade enheter i ett program.From a device template, a builder or operator can add both real and simulated devices to an application. Simulerade enheter är användbara för att testa beteendet för ditt IoT Central program innan du ansluter riktiga enheter.Simulated devices are useful for testing the behavior of your IoT Central application before you connect real devices.

I den här snabb starten lägger du till en enhets mall för en ESP32-Azure IoT kit-utvecklings tavla och skapar en simulerad enhet.In this quickstart, you add a device template for an ESP32-Azure IoT Kit development board and create a simulated device. För att slutföra den här snabb starten behöver du inte en riktig enhet, men du arbetar med en simulering av enheten.To complete this quickstart you don't need a real device, you work with a simulation of the device. En ESP32-enhet:An ESP32 device:

  • Skickar telemetri som temperatur.Sends telemetry such as temperature.
  • Rapporterar enhetsspecifika egenskaper, till exempel maximal temperatur sedan enheten startades om.Reports device-specific properties such as the maximum temperature since the device rebooted.
  • Svarar på kommandon som till exempel omstart.Responds to commands such as reboot.
  • Rapporterar allmänna enhets egenskaper, t. ex. version och serie nummer för inbyggd program vara.Reports generic device properties such as firmware version and serial number.

FörutsättningarPrerequisites

Slutför snabb starten skapa ett Azure IoT Central-program för att skapa ett IoT Central program med hjälp av den anpassade appen > anpassade program .Complete the Create an Azure IoT Central application quickstart to create an IoT Central application using the Custom app > Custom application template.

Skapa en enhetsmallCreate a device template

Som ett verktyg kan du skapa och redigera mallar för enheter i IoT Central program.As a builder, you can create and edit device templates in your IoT Central application. När du har publicerat en enhets mall kan du generera en simulerad enhet eller ansluta riktiga enheter från enhets mal len.After you publish a device template, you can generate simulated device or connect real devices from the device template. Med simulerade enheter kan du testa appens beteende innan du ansluter en riktig enhet.Simulated devices let you test the behavior of your application before you connect a real device.

Om du vill lägga till en ny enhets mall i programmet väljer du fliken enhets mallar i den vänstra rutan.To add a new device template to your application, select the Device Templates tab in the left pane.

Skärm bild som visar en tom lista över enhetsspecifika mallar

En enhets mall innehåller en enhets modell som definierar:A device template includes a device model that defines:

  • Den telemetri som enheten skickar.The telemetry the device sends.
  • Enhets egenskaper.Device properties.
  • De kommandon som enheten svarar på.The commands the device responds to.

Lägga till en enhetsmallAdd a device template

Det finns flera alternativ för att lägga till en enhets modell till ditt IoT Central-program.There are several options for adding a device model to your IoT Central application. Du kan skapa en modell från grunden, importera en modell från en fil eller välja en enhet från enhets katalogen.You can create a model from scratch, import a model from a file, or select a device from the device catalog. IoT Central också stöd för en enhets-första metod där programmet automatiskt importerar en modell från en lagrings plats när en riktig enhet ansluter för första gången.IoT Central also supports a device-first approach where the application automatically imports a model from a repository when a real device connects for the first time.

I den här snabb starten väljer du en enhet från enhets katalogen för att skapa en enhets mall.In this quickstart, you choose a device from the device catalog to create a device template.

Följande steg visar hur du använder enhets katalogen för att importera modellen för en ESP32 -enhet.The following steps show you how to use the device catalog to import the model for an ESP32 device. De här enheterna skickar telemetri, till exempel temperatur, till ditt program:These devices send telemetry, such as temperature, to your application:

  1. Om du vill lägga till en ny enhets mall väljer du + ny på sidan mallar för enheter .To add a new device template, select + New on the Device templates page.

  2. På sidan Välj typ bläddrar du nedåt tills du hittar panelen ESP32-Azure IoT kit i avsnittet Använd en förkonfigurerad enhets mall .On the Select type page, scroll down until you find the ESP32-Azure IoT Kit tile in the Use a preconfigured device template section.

  3. Välj panelen ESP32 – Azure IoT kit och välj sedan Nästa: granska.Select the ESP32-Azure IoT Kit tile, and then select Next: Review.

  4. På sidan Granska väljer du skapa.On the Review page, select Create.

  5. Efter några sekunder kan du se din nya enhets mall:After a few seconds, you can see your new device template:

    Skärm bild som visar enhets mal len för ESP32-enheten

    Namnet på mallen är sensor styrenhet.The name of the template is Sensor Controller. Modellen innehåller komponenter som sensor styrenhet, SensorTemp och enhets informations gränssnitt.The model includes components such as Sensor Controller, SensorTemp, and Device Information interface. Komponenter definierar funktionerna för en ESP32-enhet.Components define the capabilities of an ESP32 device. Funktionerna omfattar telemetri, egenskaper och kommandon.Capabilities include the telemetry, properties, and commands.

Lägga till molnegenskaperAdd cloud properties

En enhets mall kan innehålla moln egenskaper.A device template can include cloud properties. Moln egenskaper finns bara i IoT Central programmet och skickas aldrig till eller tas emot från en enhet.Cloud properties only exist in the IoT Central application and are never sent to, or received from, a device. Så här lägger du till två moln egenskaper:To add two cloud properties:

  1. Välj moln egenskaper och sedan + Lägg till moln egenskap.Select Cloud Properties and then + Add cloud property. Använd informationen i följande tabell för att lägga till två moln egenskaper till din enhets mall:Use the information in the following table to add two cloud properties to your device template:

    VisningsnamnDisplay Name Semantisk typSemantic Type SchemaSchema
    Senaste servicedatumLast Service Date IngetNone DatumDate
    KundnamnCustomer Name IngetNone SträngString
  2. Välj Spara för att spara ändringarna:Select Save to save your changes:

    Skärm bild som visar två moln egenskaper

VyerViews

Som ett verktyg kan du anpassa programmet för att visa relevant information om enheten till en operatör.As a builder, you can customize the application to display relevant information about the device to an operator. Anpassningarna gör att operatören kan hantera enheter som är anslutna till programmet.Your customizations enable the operator to manage the devices connected to the application. Du kan skapa två typer av vyer för en operator som ska användas för att interagera med enheter:You can create two types of views for an operator to use to interact with devices:

  • Formulär för att visa och redigera egenskaper för enhet och moln.Forms to view and edit device and cloud properties.
  • Instrument paneler för att visualisera enheter, inklusive telemetri som de skickar.Dashboards to visualize devices including the telemetry they send.

StandardvyerDefault views

Standardvyer är ett snabbt sätt att komma igång med att visualisera viktig enhets information.Default views are a quick way to get started with visualizing your important device information. Du kan ha upp till tre standardvyer som genereras för din enhets mall:You can have up to three default views generated for your device template:

  • I vyn kommandon kan operatören skicka kommandon till din enhet.The Commands view lets your operator dispatch commands to your device.
  • I vyn Översikt används diagram och mått för att Visa telemetri för enheter.The Overview view uses charts and metrics to display device telemetry.
  • I vyn om visas enhets egenskaper.The About view displays device properties.

Välj noden vyer i enhets mal len.Select the Views node in the device template. Du kan se att IoT Central genererade en Översikt och en om -vy åt dig när du lade till mallen.You can see that IoT Central generated an Overview and an About view for you when you added the template.

För att lägga till ett nytt hanterat enhets formulär som en operatör kan använda för att hantera enheten:To add a new Manage device form that an operator can use to manage the device:

  1. Välj noden vyer och välj sedan panelen Redigera enhet och moln data för att lägga till en ny vy.Select the Views node, and then select the Editing device and cloud data tile to add a new view.

  2. Ändra formulär namnet för att hantera enheten.Change the form name to Manage device.

  3. Välj kundens namn och senaste service datum för moln egenskaper och egenskapen mål temperatur .Select the Customer Name and Last Service Date cloud properties, and the Target Temperature property. Välj sedan Lägg till avsnitt:Then select Add section:

    Skärm bild som visar nytt formulär tillagt i enhets mal len

  4. Spara ditt nya formulär genom att välja Spara .Select Save to save your new form.

Publicera enhets mal lenPublish device template

Innan du kan skapa en simulerad enhet eller ansluta en riktig enhet måste du publicera din enhets mall.Before you can create a simulated device, or connect a real device, you need to publish your device template. Även om IoT Central har publicerat mallen när du först skapade den, måste du publicera den uppdaterade versionen.Although IoT Central published the template when you first created it, you must publish the updated version.

Så här publicerar du en enhets mal len:To publish a device template:

  1. Gå till enhets mal len för sensor styrenheten från sidan mallar för enheter .Navigate to your Sensor Controller device template from the Device templates page.

  2. Välj publicera:Select Publish:

    Skärm bild som visar platsen för publicerings ikonen

  3. I den publicera den här enhets mal len i program dialog rutan väljer du publicera.On the Publish this device template to the application dialog, select Publish.

När du har publicerat en enhets mall visas den på sidan enheter .After you publish a device template, it's visible on the Devices page. I en publicerad enhets mall kan du inte redigera en enhets modell utan att skapa en ny version.In a published device template, you can't edit a device model without creating a new version. Du kan dock ändra moln egenskaper, anpassningar och vyer i en publicerad enhets mall utan versions hantering.However, you can modify cloud properties, customizations, and views in a published device template without versioning. När du har gjort några ändringar väljer du publicera för att skicka ut ändringarna till din operatör.After making any changes, select Publish to push those changes out to your operator.

Lägga till en simulerad enhetAdd a simulated device

Om du vill lägga till en simulerad enhet i programmet använder du enhets mal len ESP32 som du skapade.To add a simulated device to your application, you use the ESP32 device template you created.

  1. Om du vill lägga till en ny enhet som en operatör väljer du enheter i den vänstra rutan.To add a new device as an operator choose Devices in the left pane. Fliken enheter visar alla enheter och enhets mal len för sensor styrenheten för ESP32-enheten.The Devices tab shows All devices and the Sensor Controller device template for the ESP32 device. Välj sensor styrenhet.Select Sensor Controller.

  2. Om du vill lägga till en simulerad DevKit-enhet väljer du + ny.To add a simulated DevKit device, select + New. Använd det föreslagna enhets-ID: t eller ange ditt eget.Use the suggested Device ID or enter your own. Ett enhets-ID kan innehålla bokstäver, siffror och - tecken.A device ID can contain letters, numbers, and the - character. Du kan också ange ett namn på den nya enheten.You can also enter a name for your new device. Se till att simulera att enheten är inställd på Ja och välj sedan skapa.Make sure the Simulate this device is set to Yes and then select Create.

    Skärm bild som visar den simulerade sensor styrenhets enheten

Nu kan du interagera med de vyer som har skapats av verktyget för enhets mal len med simulerade data:Now you can interact with the views that were created by the builder for the device template using simulated data:

  1. Välj den simulerade enheten på sidan enheterSelect your simulated device on the Devices page

    • I vyn Översikt visas ett observations område för den simulerade Telemetrin:The Overview view shows a plot of the simulated telemetry:

      Skärm bild som visar översikts sidan för simulerad enhet

    • Vyn About visar egenskaps värden.The About view shows property values.

    • I vyn kommandon kan du köra kommandon, t. ex. omstart på enheten.The Commands view lets you run commands, such as reboot on the device.

    • Vyn Hantera enheter är det formulär som du skapade för operatören för att hantera enheten.The Manage devices view is the form you created for the operator to manage the device.

    • I vyn rå data kan du Visa de obehandlade telemetri-och egenskaps värden som skickas av enheten.The Raw data view lets you view the raw telemetry and property values sent by the device. Den här vyn är användbar för fel sökning av enheter.This view is useful for debugging devices.

Använd en simulerad enhet för att förbättra vyerUse a simulated device to improve views

När du har skapat en ny simulerad enhet kan verktyget använda den här enheten för att fortsätta att förbättra och bygga på vyerna för enhets mal len.After you create a new simulated device, the builder can use this device to continue to improve and build upon the views for the device template.

  1. Välj enhets mallar i den vänstra rutan och välj mallen för sensor styrenheten .Choose Device templates in the left pane and select the Sensor Controller template.

  2. Välj någon av de vyer som du vill redigera, till exempel Översikt, eller skapa en ny vy.Select any of the views you'd like to edit such as Overview, or create a new view. Välj Konfigurera för hands versions enhet och Välj sedan från en enhet som körs.Select Configure preview device, then Select from a running device. Här kan du välja att inte ha någon förhands gransknings enhet, en riktig enhet som kon figurer ATS för testning eller en befintlig enhet som du har lagt till i IoT Central.Here you can choose to have no preview device, a real device configured for testing, or an existing device you've added into IoT Central.

  3. Välj den simulerade enheten i listan.Choose your simulated device in the list. Välj sedan Använd.Then select Apply. Nu kan du se samma simulerade enhet i din enhets mall för att skapa upplevelser.Now you can see the same simulated device in your device template views building experience. Den här vyn är användbar för diagram och andra visualiseringar.This view is useful for charts and other visualizations.

    Skärm bild som visar en konfigurerad förhands gransknings enhet

Rensa resurserClean up resources

Om du inte planerar att slutföra ytterligare IoT Central snabb starter eller självstudier kan du ta bort ditt IoT Central-program:If you don't plan to complete any further IoT Central quickstarts or tutorials, you can delete your IoT Central application:

  1. I ditt IoT Central program navigerar du till Administration > ditt program.In your IoT Central application, navigate to Administration > Your application.
  2. Välj ta bort och bekräfta sedan åtgärden.Select Delete and then confirm your action.

Nästa stegNext steps

I den här snabb starten har du lärt dig hur du skapar en enhets mall för sensor styrenhet för en ESP32-enhet och lägger till en simulerad enhet i programmet.In this quickstart, you learned how to you create a Sensor Controller device template for an ESP32 device and add a simulated device to your application.

Om du vill veta mer om övervakning av enheter som är anslutna till ditt program fortsätter du till snabb starten:To learn more about monitoring devices connected to your application, continue to the quickstart: