Připojení zařízení IoT DevKit k akcelerátoru řešení vzdáleného monitorováníConnect an IoT DevKit device to the Remote Monitoring solution accelerator

V tomto kurzu implementujete chladicí zařízení, které pošle následující telemetrii do akcelerátoru řešenívzdáleného monitorování:In this tutorial, you implement a Chiller device that sends the following telemetry to the Remote Monitoring solution accelerator:

  • TeplotaTemperature
  • CitlivostPressure
  • VlhkostHumidity

Pro zjednodušení kód generuje ukázkové hodnoty telemetrie pro chlazení.For simplicity, the code generates sample telemetry values for the Chiller. Ukázku můžete roztáhnout připojením skutečných senzorů k vašemu zařízení a odesláním skutečné telemetrie.You could extend the sample by connecting real sensors to your device and sending real telemetry.

Ukázkové zařízení také:The sample device also:

  • Odešle metadata do řešení, aby bylo možné popsat jeho schopnosti.Sends metadata to the solution to describe its capabilities.
  • Reaguje na akce aktivované na stránce zařízení v řešení.Responds to actions triggered from the Devices page in the solution.
  • Reaguje na změny konfigurace odesílané ze stránky zařízení v řešení.Responds to configuration changes send from the Devices page in the solution.

K dokončení tohoto kurzu potřebujete mít aktivní účet Azure.To complete this tutorial, you need an active Azure account. Pokud účet nemáte, můžete si během několika minut vytvořit bezplatný zkušební účet.If you don't have an account, you can create a free trial account in just a couple of minutes. Podrobnosti najdete v článku Bezplatná zkušební verze Azure.For details, see Azure Free Trial.

Než začneteBefore you start

Než napíšete kód pro vaše zařízení, nasaďte akcelerátor řešení vzdáleného monitorování a přidejte do řešení nové reálné zařízení.Before you write any code for your device, deploy your Remote Monitoring solution accelerator and add a new real device to the solution.

Nasazení akcelerátoru řešení vzdáleného monitorováníDeploy your Remote Monitoring solution accelerator

Chladicí zařízení, které v tomto kurzu vytvoříte, odesílá data do instance akcelerátoru řešení vzdáleného monitorování .The Chiller device you create in this tutorial sends data to an instance of the Remote Monitoring solution accelerator. Pokud jste ve svém účtu Azure ještě nezřídili akcelerátor řešení vzdáleného monitorování, přečtěte si téma nasazení akcelerátoru řešení vzdáleného monitorování .If you haven't already provisioned the Remote Monitoring solution accelerator in your Azure account, see Deploy the Remote Monitoring solution accelerator

Po dokončení procesu nasazení pro řešení vzdáleného monitorování kliknutím na Spustit otevřete řídicí panel řešení v prohlížeči.When the deployment process for the Remote Monitoring solution finishes, click Launch to open the solution dashboard in your browser.

Řídicí panel řešení

Přidání zařízení do řešení vzdáleného monitorováníAdd your device to the Remote Monitoring solution

Poznámka

Pokud jste už zařízení ve svém řešení přidali, můžete tento krok přeskočit.If you have already added a device in your solution, you can skip this step. Další krok ale vyžaduje připojovací řetězec zařízení.However, the next step requires your device connection string. Připojovací řetězec zařízení můžete načíst z Azure Portal nebo pomocí nástroje AZ IoT CLI.You can retrieve a device's connection string from the Azure portal or using the az iot CLI tool.

Aby se zařízení mohlo připojit k akcelerátoru řešení, musí identifikovat sebe, aby IoT Hub s použitím platných přihlašovacích údajů.For a device to connect to the solution accelerator, it must identify itself to IoT Hub using valid credentials. Po přidání zařízení do řešení máte možnost Uložit připojovací řetězec zařízení, který tyto přihlašovací údaje obsahuje.You have the opportunity to save the device connection string that contains these credentials when you add the device to the solution. Připojovací řetězec zařízení zahrnete do klientské aplikace dále v tomto kurzu.You include the device connection string in your client application later in this tutorial.

Pokud chcete přidat zařízení do řešení vzdáleného monitorování, na stránce Device Explorer v řešení proveďte následující kroky:To add a device to your Remote Monitoring solution, complete the following steps on the Device Explorer page in the solution:

  1. Zvolte + nové zařízenía pak jako typ zařízenízvolte reálné :Choose + New device, and then choose Real as the Device type:

    Přidání skutečného zařízení

  2. Jako ID zařízení zadejte fyzický-chladicí zařízení.Enter Physical-chiller as the Device ID. Vyberte možnosti symetrického klíče a Automatické generování klíčů :Choose the Symmetric Key and Auto generate keys options:

    Zvolit možnosti zařízení

  3. Zvolte Použít.Choose Apply. Pak si poznamenejte hodnoty primárního klíče pro ID zařízení, primární klíča připojovací řetězec :Then make a note of the Device ID, Primary Key, and Connection string primary key values:

    Načíst přihlašovací údaje

Nyní jste přidali reálné zařízení do akcelerátoru řešení vzdáleného monitorování a poznamenali jste jeho připojovací řetězec zařízení.You've now added a real device to the Remote Monitoring solution accelerator and noted its device connection string. V následujících částech implementujete klientskou aplikaci, která pro připojení k vašemu řešení používá připojovací řetězec zařízení.In the following sections, you implement the client application that uses the device connection string to connect to your solution.

Klientská aplikace implementuje vestavěný model chladicího zařízení.The client application implements the built-in Chiller device model. Model zařízení akcelerátoru řešení určuje následující informace o zařízení:A solution accelerator device model specifies the following about a device:

  • Vlastnosti zařízení hlásí řešení.The properties the device reports to the solution. Například zařízení chlazení hlásí informace o jeho firmwaru a umístění.For example, a Chiller device reports information about its firmware and location.
  • Typy telemetrie, které zařízení odesílá do řešení.The types of telemetry the device sends to the solution. Například chladicí zařízení odesílá hodnoty teploty, vlhkosti a tlaku.For example, a Chiller device sends temperature, humidity, and pressure values.
  • Metody, které můžete naplánovat v řešení, které se má spustit na zařízení.The methods you can schedule from the solution to run on the device. Například chladicí zařízení musí implementovat metody restart, FirmwareUpdate, EmergencyValveReleasea IncreasePressure .For example, a Chiller device must implement Reboot, FirmwareUpdate, EmergencyValveRelease, and IncreasePressure methods.

V této příručce se dozvíte, jak spustit ukázkovou aplikaci na zařízení IoT DevKit.This how-to guide shows you how to run a sample application on your IoT DevKit device. Vzorový kód pošle telemetrii ze senzorů na zařízení DevKit do akcelerátoru řešení.The sample code sends telemetry from the sensors on the DevKit device to your solution accelerator.

MXChip IoT DevKit je vše v Arduino kompatibilní vývěsce s bohatými periferními zařízeními a snímači.The MXChip IoT DevKit is an all-in-one Arduino compatible board with rich peripherals and sensors. Můžete ji vyvíjet pro IT pomocí Azure IoT Device Workbench nebo rozšíření sady nástrojů Azure iot Tools v Visual Studio Code.You can develop for it using Azure IoT Device Workbench or Azure IoT Tools extension pack in Visual Studio Code. Katalog projektů obsahuje ukázkové aplikace, které vám pomůžou prototypovat řešení IoT.The projects catalog contains sample applications to help you prototype IoT solutions.

Před zahájenímBefore you begin

K dokončení kroků v tomto kurzu nejdříve proveďte následující úlohy:To complete the steps in this tutorial, first do the following tasks:

Otevřít ukázkový projektOpen sample project

Chcete-li otevřít ukázku vzdáleného monitorování v VS Code:To open the Remote Monitoring sample in VS Code:

  1. Ujistěte se, že vaše aplikace IoT DevKit není k vašemu počítači.Make sure your IoT DevKit isn't to your computer. Nejprve začněte VS Code a pak připojte DevKit k počítači.Start VS Code first, and then connect the DevKit to your computer.

  2. Kliknutím F1 otevřete paletu příkazů, zadáte a vyberete Azure IoT Device Workbench: otevřít příklady.... Pak jako panel vyberte IoT DevKit .Click F1 to open the command palette, type and select Azure IoT Device Workbench: Open Examples.... Then select IoT DevKit as board.

  3. Najděte vzdálené monitorování a klikněte na otevřít ukázku.Find Remote Monitoring and click Open Sample. Otevře se nové okno VS Code, ve kterém se zobrazí složka projektu:A new VS Code window opens showing the project folder:

    IoT Workbench, vyberte příklad vzdáleného monitorování.

Konfigurace zařízeníConfigure the device

Konfigurace IoT Hubho připojovacího řetězce zařízení na zařízení DevKit:To configure IoT Hub device connection string on your DevKit device:

  1. Přepněte IoT DevKit do režimu konfigurace:Switch the IoT DevKit into Configuration mode:

    • Podržte tlačítko A.Hold down button A.
    • Vložení a uvolnění tlačítka obnovitPush and release the Reset button.
  2. Na obrazovce se zobrazí ID DevKit a Configuration.The screen displays the DevKit ID and Configuration.

    Konfigurační režim IoT DevKit

  3. Stisknutím klávesy F1 otevřete paletu příkazů, potom zadejte a vyberte Azure IoT Device Workbench: Konfigurace nastavení zařízení... > připojovací řetězec zařízení.Press F1 to open the command palette, type and select Azure IoT Device Workbench: Configure Device Settings... > Config Device Connection String.

  4. Vložte připojovací řetězec, který jste zkopírovali dříve, a stisknutím klávesy ENTER nakonfigurujte zařízení.Paste the connection string you copied previously and press Enter to configure the device.

Sestavení kóduBuild the code

Postup sestavení a nahrání kódu zařízení:To build and upload the device code:

  1. Stisknutím F1 otevřete paletu příkazů, zadáte a vyberete Azure IoT Device Workbench: nahrání kódu zařízení:Press F1 to open the command palette, type and select Azure IoT Device Workbench: Upload Device Code:

  2. VS Code zkompiluje a nahraje kód do zařízení DevKit:VS Code compiles and uploads the code to your DevKit device:

    IoT Workbench: nahrání zařízení >

  3. Zařízení DevKit se restartuje a spustí kód, který jste nahráli.The DevKit device reboots and runs the code you uploaded.

Test ukázkyTest the sample

Pokud chcete ověřit, že ukázková aplikace, kterou jste nahráli do zařízení DevKit, funguje, proveďte následující kroky:To verify that the sample application you uploaded to the DevKit device is working, complete the following steps:

Zobrazit telemetrii odeslanou do řešení vzdáleného monitorováníView the telemetry sent to Remote Monitoring solution

Po spuštění ukázkové aplikace odešle zařízení DevKit telemetrii z dat senzorů přes Wi-Fi do vašeho akcelerátoru řešení.When the sample app runs, the DevKit device sends telemetry from its sensors data over Wi-Fi to your solution accelerator. Zobrazení telemetrie:To see the telemetry:

  1. Přejděte na řídicí panel řešení a klikněte na Device Explorer.Go to your solution dashboard, and click Device Explorer.

  2. Klikněte na název zařízení zařízení DevKit.Click on the device name of your DevKit device. na kartě na pravé straně můžete zobrazit telemetrii z DevKit v reálném čase:on the right-hand tab, you can see the telemetry from the DevKit in real time:

    Data senzorů v Azure IoT Suite

Řízení zařízení DevKitControl the DevKit device

Akcelerátor řešení vzdáleného monitorování umožňuje vzdálené řízení zařízení.The Remote Monitoring solution accelerator lets you control your device remotely. Vzorový kód implementuje tři metody, které lze zobrazit v části Metoda , když vyberete zařízení na stránce Device Explorer :The sample code implements three methods that you can see in the Method section when you select the device on the Device Explorer page:

Metody IoT DevKit

Chcete-li změnit barvu jedné z DevKit diody LED, použijte metodu LedColor :To change the color of one of the DevKit LEDs, use the LedColor method:

  1. Vyberte název zařízení ze seznamu zařízení a klikněte na úlohy:Select the device name from device list and click on the Jobs:

    Vytvoření úlohy

  2. Nakonfigurujte úlohy pomocí následujících hodnot a klikněte na použít:Configure the Jobs using the following values and click Apply:

    • Vyberte úlohu: metoda RunSelect Job: Run method

    • Název metody: LedColorMethod name: LedColor

    • Název úlohy: ChangeLedColorJob Name: ChangeLedColor

      Nastavení úlohy

  3. Po několika sekundách barva INDIKÁTORu RGB (pod tlačítkem A) na DevKit změny:After a couple of seconds, the color of the RGB LED (below the button A) on your DevKit changes:

    DevKit Red LED pro IoT

Vyčištění prostředkůClean up resources

Pokud se budete chtít přesunout ke kurzům, ponechte akcelerátor řešení pro vzdálené monitorování nasazený.If you plan to move on to the tutorials, leave the Remote Monitoring solution accelerator deployed.

Pokud už akcelerátor řešení nepotřebujete, odstraňte ho ze stránky zřízené řešení, a to tak, že ho vyberete a pak kliknete na odstranit řešení:If you no longer need the solution accelerator, delete it from the Provisioned solutions page, by selecting it, and then clicking Delete Solution:

Odstranění řešení

Problémy a zpětná vazbaProblems and feedback

Pokud narazíte na nějaké problémy, přečtěte si Nejčastější dotazy k IoT DevKit nebo se můžete obrátit na nás s použitím následujících kanálů:If you run into any problems, refer to the IoT DevKit FAQs or reach out to us using the following channels:

Další krokyNext steps

Teď, když jste se naučili připojit zařízení DevKit k akcelerátoru řešení vzdáleného monitorování, je tady několik navrhovaných dalších kroků:Now that you've learned how to connect a DevKit device to your Remote Monitoring solution accelerator, here are some suggested next steps: