Szybki start: dodawanie symulowanego urządzenia do aplikacji IoT Central aplikacjiQuickstart: Add a simulated device to your IoT Central application

Szablon urządzenia definiuje możliwości urządzenia, które łączy się z twoją IoT Central aplikacji.A device template defines the capabilities of a device that connects to your IoT Central application. Możliwości obejmują dane telemetryczne wysyłane przez urządzenie, właściwości urządzenia i polecenia, na które reaguje urządzenie.Capabilities include telemetry the device sends, device properties, and the commands a device responds to. Za pomocą szablonu urządzenia można dodać do aplikacji zarówno rzeczywiste, jak i symulowane urządzenia.Using a device template you can add both real and simulated devices to an application. Symulowane urządzenia są przydatne do testowania zachowania aplikacji IoT Central przed podłączeniem rzeczywistych urządzeń.Simulated devices are useful for testing the behavior of your IoT Central application before you connect real devices.

W tym przewodniku Szybki start dodasz szablon urządzenia dla tablicy dewelopera ESP32-Azure zestawu IoT Kit i utworzysz urządzenie symulowane.In this quickstart, you add a device template for an ESP32-Azure IoT Kit development board and create a simulated device. Aby ukończyć ten przewodnik Szybki start, nie potrzebujesz rzeczywistego urządzenia, pracujesz z symulacją urządzenia.To complete this quickstart you don't need a real device, you work with a simulation of the device. Urządzenie ESP32:An ESP32 device:

  • Wysyła dane telemetryczne, takie jak temperatura.Sends telemetry such as temperature.
  • Raportuje właściwości specyficzne dla urządzenia, takie jak maksymalna temperatura od momentu ponownego uruchomienia urządzenia.Reports device-specific properties such as the maximum temperature since the device rebooted.
  • Odpowiada na polecenia, takie jak ponowne uruchomienie.Responds to commands such as reboot.
  • Raportuje ogólne właściwości urządzenia, takie jak wersja oprogramowania układowego i numer seryjny.Reports generic device properties such as firmware version and serial number.

Wymagania wstępnePrerequisites

Ukończ przewodnik Szybki start Tworzenie Azure IoT Central aplikacji, aby utworzyć aplikację IoT Central przy użyciu szablonu aplikacji niestandardowej > aplikacji niestandardowej.Complete the Create an Azure IoT Central application quickstart to create an IoT Central application using the Custom app > Custom application template.

Tworzenie szablonu urządzeniaCreate a device template

Aby dodać nowy szablon urządzenia do aplikacji, wybierz kartę Szablony urządzeń w okienku po lewej stronie.To add a new device template to your application, select the Device Templates tab in the left pane.

Zrzut ekranu przedstawiający pustą listę szablonów urządzeń

Szablon urządzenia zawiera model urządzenia, który definiuje:A device template includes a device model that defines:

  • Dane telemetryczne wysyłane przez urządzenie.The telemetry the device sends.
  • Właściwości urządzenia.Device properties.
  • Polecenia, na które reaguje urządzenie.The commands the device responds to.

Dodawanie szablonu urządzeniaAdd a device template

Istnieje kilka opcji dodawania modelu urządzenia do IoT Central aplikacji.There are several options for adding a device model to your IoT Central application. Możesz utworzyć model od podstaw, zaimportować model z pliku lub wybrać urządzenie z katalogu urządzeń.You can create a model from scratch, import a model from a file, or select a device from the device catalog. IoT Central obsługuje również podejście oparte na urządzeniu, w którym aplikacja automatycznie importuje model z repozytorium, gdy rzeczywiste urządzenie łączy się po raz pierwszy.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.

W tym przewodniku Szybki start wybierzesz urządzenie z katalogu urządzeń, aby utworzyć szablon urządzenia.In this quickstart, you choose a device from the device catalog to create a device template.

Poniższe kroki pokazują, jak zaimportować model dla urządzenia ESP32 za pomocą katalogu urządzeń.The following steps show you how to use the device catalog to import the model for an ESP32 device. Te urządzenia wysyłają dane telemetryczne, takie jak temperatura, do aplikacji:These devices send telemetry, such as temperature, to your application:

  1. Aby dodać nowy szablon urządzenia, wybierz pozycję + Nowy na stronie Szablony urządzeń.To add a new device template, select + New on the Device templates page.

  2. Na stronie Wybierz typ przewiń w dół do kafelka ESP32-Azure IoT Kit w sekcji Korzystanie ze wstępnie skonfigurowanego szablonu urządzenia.On the Select type page, scroll down until you find the ESP32-Azure IoT Kit tile in the Use a pre-configured device template section.

  3. Wybierz kafelek ESP32-Azure IoT Kit, a następnie wybierz pozycję Dalej: Przegląd.Select the ESP32-Azure IoT Kit tile, and then select Next: Review.

  4. Na stronie Przegląd wybierz pozycję Utwórz.On the Review page, select Create.

  5. Po kilku sekundach zobaczysz nowy szablon urządzenia:After a few seconds, you can see your new device template:

    Zrzut ekranu przedstawiający szablon urządzenia dla urządzenia ESP32

    Nazwa szablonu to Sensor Controller.The name of the template is Sensor Controller. Model zawiera składniki, takie jak Sensor Controller, SensorTemp i interfejs informacji o urządzeniu.The model includes components such as Sensor Controller, SensorTemp, and Device Information interface. Składniki definiują możliwości urządzenia ESP32.Components define the capabilities of an ESP32 device. Możliwości obejmują telemetrię, właściwości i polecenia.Capabilities include the telemetry, properties, and commands.

Dodawanie właściwości chmuryAdd cloud properties

Szablon urządzenia może zawierać właściwości chmury.A device template can include cloud properties. Właściwości chmury istnieją tylko w aplikacji IoT Central i nigdy nie są wysyłane do urządzenia ani z nich odbierane.Cloud properties only exist in the IoT Central application and are never sent to, or received from, a device. Aby dodać dwie właściwości chmury:To add two cloud properties:

  1. Wybierz pozycję Właściwości chmury, a następnie pozycję + Dodaj właściwość chmury.Select Cloud Properties and then + Add cloud property. Skorzystaj z informacji w poniższej tabeli, aby dodać dwie właściwości chmury do szablonu urządzenia:Use the information in the following table to add two cloud properties to your device template:

    Nazwa wyświetlanaDisplay Name Typ semantycznySemantic Type SchematSchema
    Data ostatniego serwisowaniaLast Service Date BrakNone Date (Data)Date
    Nazwa klientaCustomer Name BrakNone CiągString
  2. Wybierz pozycję Zapisz, aby zapisać zmiany:Select Save to save your changes:

    Zrzut ekranu przedstawiający dwie właściwości chmury

WidokiViews

Możesz dostosować aplikację, aby wyświetlała odpowiednie informacje o urządzeniu.You can customize the application to display relevant information about the device. Dostosowania umożliwiają innym użytkownikom zarządzanie urządzeniami połączonymi z aplikacją.Customizations enable other to manage the devices connected to the application. Możesz utworzyć dwa typy widoków do interakcji z urządzeniami:You can create two types of views to interact with devices:

  • Formularze do wyświetlania i edytowania właściwości urządzenia i chmury.Forms to view and edit device and cloud properties.
  • Pulpity nawigacyjne do wizualizacji urządzeń, w tym danych telemetrycznych, które wysyłają.Dashboards to visualize devices including the telemetry they send.

Widoki domyślneDefault views

Widoki domyślne to szybki sposób na wprowadzenie do wizualizowania ważnych informacji o urządzeniu.Default views are a quick way to get started with visualizing your important device information. Szablon urządzenia może mieć maksymalnie trzy widoki domyślne:You can have up to three default views generated for your device template:

  • Widok Polecenia umożliwia wysyłanie poleceń do urządzenia.The Commands view lets you dispatch commands to your device.
  • Widok Przegląd używa wykresów i metryk do wyświetlania danych telemetrycznych urządzenia.The Overview view uses charts and metrics to display device telemetry.
  • Widok Informacje zawiera właściwości urządzenia.The About view displays device properties.

Wybierz węzeł Widoki w szablonie urządzenia.Select the Views node in the device template. Po dodaniu IoT Central są generowane widoki Przegląd, Informacje i Dane pierwotne. You can see that IoT Central generated the Overview, About, and Raw Data views for you when you added the template.

Aby dodać nowy formularz do zarządzania urządzeniem:To add a new form to manage the device:

  1. Wybierz węzeł Widoki, a następnie wybierz kafelek Edytowanie danych urządzenia i chmury, aby dodać nowy widok.Select the Views node, and then select the Editing device and cloud data tile to add a new view.

  2. Zmień nazwę formularza na Zarządzaj urządzeniem.Change the form name to Manage device.

  3. Wybierz właściwości chmury Customer Name (Nazwa klienta) i Last Service Date (Data ostatniej usługi) i Target Temperature (Temperatura docelowa).Select the Customer Name and Last Service Date cloud properties, and the Target Temperature property. Następnie wybierz pozycję Dodaj sekcję:Then select Add section:

    Zrzut ekranu przedstawiający nowy formularz dodany do szablonu urządzenia

  4. Wybierz pozycję Zapisz, aby zapisać nowy formularz.Select Save to save your new form.

Publikowanie szablonu urządzeniaPublish device template

Aby można było utworzyć symulowane urządzenie lub połączyć rzeczywiste urządzenie, należy opublikować szablon urządzenia.Before you can create a simulated device, or connect a real device, you need to publish your device template. Chociaż IoT Central szablon został opublikowany podczas jego pierwszego utworzenia, należy opublikować zaktualizowaną wersję.Although IoT Central published the template when you first created it, you must publish the updated version.

Aby opublikować szablon urządzenia:To publish a device template:

  1. Przejdź do szablonu urządzenia Sensor Controller na stronie Szablony urządzeń.Navigate to your Sensor Controller device template from the Device templates page.

  2. Wybierz pozycję Publikuj na pasku poleceń w górnej części strony.Select Publish from the command bar at the top of the page.

  3. W wyświetlonym oknie dialogowym wybierz pozycję Opublikuj.On the dialog that appears, select Publish.

Po opublikowaniu szablonu urządzenia będzie on widoczny na stronie Urządzenia.After you publish a device template, it's visible on the Devices page. W opublikowanym szablonie urządzenia nie można edytować modelu urządzenia bez tworzenia nowej wersji.In a published device template, you can't edit a device model without creating a new version. Można jednak modyfikować właściwości, dostosowania i widoki chmury w opublikowanym szablonie urządzenia bez konieczności zarządzania wersjami.However, you can modify cloud properties, customizations, and views in a published device template without versioning. Po w związku z wprowadzeniem jakichkolwiek zmian wybierz pozycję Publikuj, aby wypchnąć te zmiany do użycia na rzeczywistych i symulowanych urządzeniach.After making any changes, select Publish to push those changes for real and simulated devices to use.

Dodawanie symulowanego urządzeniaAdd a simulated device

Aby dodać symulowane urządzenie do aplikacji, użyj utworzonego szablonu urządzenia ESP32.To add a simulated device to your application, use the ESP32 device template you created.

  1. Aby dodać nowe urządzenie, wybierz pozycję Urządzenia w okienku po lewej stronie.To add a new device choose Devices in the left pane. Karta Urządzenia zawiera pozycję Wszystkie urządzenia i szablon urządzenia Kontroler czujnika dla urządzenia ESP32.The Devices tab shows All devices and the Sensor Controller device template for the ESP32 device. Wybierz pozycję Kontroler czujnika.Select Sensor Controller.

  2. Aby dodać symulowane urządzenie DevKit, wybierz pozycję + Nowe.To add a simulated DevKit device, select + New. Użyj sugerowanego identyfikatora urządzenia lub wprowadź własny.Use the suggested Device ID or enter your own. Identyfikator urządzenia może zawierać litery, cyfry i - znak.A device ID can contain letters, numbers, and the - character. Możesz również wprowadzić nazwę nowego urządzenia.You can also enter a name for your new device. Upewnij się, że ustawienie Symulowanie tego urządzenia ma wartość Tak, a następnie wybierz pozycję Utwórz.Make sure the Simulate this device is set to Yes and then select Create.

    Zrzut ekranu przedstawiający symulowane urządzenie Sensor Controller

Teraz możesz wchodzić w interakcje z utworzonymi wcześniej widokami przy użyciu symulowanych danych:Now you can interact with the views that you created earlier using simulated data:

  1. Wybieranie symulowanego urządzenia na stronie UrządzeniaSelect your simulated device on the Devices page

    • Widok Przegląd przedstawia wykres symulowanych danych telemetrycznych:The Overview view shows a plot of the simulated telemetry:

      Zrzut ekranu przedstawiający stronę przeglądu dla symulowanego urządzenia

    • Widok Informacje zawiera wartości właściwości.The About view shows property values.

    • Widok Polecenia umożliwia uruchamianie poleceń, takich jak ponowne uruchomienie na urządzeniu.The Commands view lets you run commands, such as reboot on the device.

    • Widok Zarządzaj urządzeniami to formularz utworzony w celu zarządzania urządzeniem.The Manage devices view is the form you created to manage the device.

    • Widok Dane pierwotne umożliwia wyświetlanie nieprzetworzonych danych telemetrycznych i wartości właściwości wysyłanych przez urządzenie.The Raw data view lets you view the raw telemetry and property values sent by the device. Ten widok jest przydatny do debugowania urządzeń.This view is useful for debugging devices.

Następne krokiNext steps

W tym przewodniku Szybki start opisano sposób tworzenia szablonu urządzenia Sensor Controller dla urządzenia ESP32 i dodawania symulowanego urządzenia do aplikacji.In this quickstart, you learned how to create a Sensor Controller device template for an ESP32 device and add a simulated device to your application.

Aby dowiedzieć się więcej na temat monitorowania urządzeń połączonych z aplikacją, przejdź do przewodnika Szybki start:To learn more about monitoring devices connected to your application, continue to the quickstart: