Sdílet prostřednictvím


Rychlý start: Řízení zařízení připojeného k ioT Hubu

V tomto rychlém startu použijete přímou metodu k řízení simulovaného zařízení připojeného k centru IoT. IoT Hub je služba Azure, která umožňuje spravovat zařízení IoT z cloudu a ingestovat velké objemy telemetrie zařízení do cloudu pro ukládání nebo zpracování. Pomocí přímých metod můžete vzdáleně změnit chování zařízení připojených k centru IoT.

Rychlý start používá dvě předem psané aplikace .NET:

  • Aplikace simulovaného zařízení, která reaguje na přímé metody volané z aplikace služby. Pro příjem volání přímé metody se tato aplikace připojí ke koncovému bodu specifickému pro zařízení ve vašem centru IoT.

  • Služební aplikace, která volá přímé metody na simulovaném zařízení. Pokud chcete na zařízení volat přímou metodu, tato aplikace se připojí k servisnímu koncovému bodu ve vašem centru IoT.

Požadavky

  • Účet Azure s aktivním předplatným. Vytvořte si ho zdarma.

  • Dvě ukázkové aplikace, které spustíte v tomto rychlém startu, jsou napsané pomocí jazyka C#. Na vývojovém počítači potřebujete sadu .NET SDK 6.0 nebo vyšší.

    Sadu .NET Core SDK pro různé platformy si můžete stáhnout z webu .NET.

    Aktuální verzi C# na počítači používaném pro vývoj můžete ověřit pomocí následujícího příkazu:

    dotnet --version
    
  • Naklonujte nebo stáhněte Microsoft Azure IoT SDK pro .NET z GitHubu. Ukázkové aplikace používané v tomto rychlém startu jsou součástí sady SDK.

  • Ujistěte se, že je v bráně firewall otevřený port 8883. Ukázka zařízení v tomto rychlém startu používá protokol MQTT, který komunikuje přes port 8883. Tento port může být blokovaný v některých podnikových a vzdělávacích síťových prostředích. Další informace a způsoby, jak tento problém obejít, najdete v části Připojení ke službě IoT Hubv části Komunikace se službou IoT Hub pomocí protokolu MQTT.

Poznámka:

Tento článek používá nejnovější verzi rozšíření Azure IoT, která se nazývá azure-iot. Starší verze se nazývá azure-cli-iot-ext. Najednou byste měli mít nainstalovanou jenom jednu verzi. K ověření aktuálně nainstalovaných rozšíření můžete použít příkaz az extension list.

Pomocí az extension remove --name azure-cli-iot-ext odeberte starší verzi rozšíření.

Pomocí az extension add --name azure-iot přidejte novou verzi rozšíření.

Chcete-li zjistit, jaká rozšíření jsou aktuálně nainstalována, použijte az extension list.

V této části použijete Azure CLI k vytvoření centra IoT a skupiny prostředků. Skupina prostředků Azure je logický kontejner, ve kterém se nasazují a spravují prostředky Azure. Centrum IoT funguje jako centrální centrum zpráv pro obousměrnou komunikaci mezi vaší aplikací IoT a zařízeními.

Pokud už ve svém předplatném Azure máte centrum IoT, můžete tuto část přeskočit.

Chcete-li vytvořit centrum IoT a skupinu prostředků:

  1. Spusťte aplikaci příkazového řádku (CLI). Pokud chcete spustit příkazy rozhraní příkazového řádku ve zbývající části tohoto článku, zkopírujte syntaxi příkazu, vložte ho do aplikace CLI, upravte hodnoty proměnných a stiskněte Enter.

    • Pokud používáte Cloud Shell, vyberte v příkazech rozhraní příkazového řádku tlačítko Vyzkoušet a spusťte Cloud Shell v rozděleném okně prohlížeče. Nebo můžete Cloud Shell otevřít na samostatné kartě prohlížeče.
    • Pokud používáte Azure CLI místně, spusťte konzolovou aplikaci CLI a přihlaste se k Azure CLI.
  2. Spuštěním příkazu az extension add nainstalujte nebo upgradujte rozšíření azure-iot na aktuální verzi.

    az extension add --upgrade --name azure-iot
    
  3. V aplikaci CLI spusťte příkaz az group create k vytvoření skupiny prostředků. Následující příkaz vytvoří skupinu prostředků s názvem MyResourceGroup ve umístění eastus.

    Poznámka:

    Volitelně můžete nastavit jiné umístění. Pokud chcete zobrazit dostupná umístění, spusťte az account list-locationspříkaz . V tomto rychlém startu se používá eastus , jak je znázorněno v ukázkovém příkazu.

    az group create --name MyResourceGroup --location eastus
    
  4. Spuštěním příkazu az iot hub create vytvořte IoT Hub. Vytvoření centra IoT může trvat několik minut.

    YourIoTHubName. Nahraďte tento zástupný symbol a okolní složené závorky v následujícím příkazu pomocí názvu, který jste zvolili pro centrum IoT. Název centra IoT musí být v Azure globálně jedinečný. Ve zbývající části tohoto rychlého spuštění použijte název svého centra IoT, kdykoli vidíte zástupný symbol.

    az iot hub create --resource-group MyResourceGroup --name {YourIoTHubName}
    

Načtení připojovacího řetězce služby

Také potřebujete připojovací řetězec služby vašeho IoT Hubu, aby se služební aplikace mohla k centru připojit a načíst zprávy. Připojovací řetězec služby je pro centrum IoT jako celek a liší se od připojovacího řetězce zařízení, který jste získali v předchozí části.

Následující příkaz načte řetězec připojení pro váš IoT hub:

az iot hub connection-string show --policy-name service --hub-name {YourIoTHubName} --output table

Poznamenejte si připojovací řetězec služby, který vypadá takto:

HostName={YourIoTHubName}.azure-devices.net;SharedAccessKeyName=service;SharedAccessKey={YourSharedAccessKey}

Tuto hodnotu použijete později v rychlém startu.

Simulace zařízení

Aplikace simulovaného zařízení se připojí ke koncovému bodu specifickému pro zařízení ve vašem centru IoT, odešle simulovanou telemetrii a naslouchá volání přímých metod z vašeho centra. V tomto rychlém startu příkaz přímé metody z centra instruuje zařízení, aby nastavilo na nový interval, ve kterém odesílá telemetrii. Simulované zařízení odešle potvrzení zpět do centra poté, co spustí přímou metodu.

  1. V okně místního terminálu přejděte do kořenové složky sady SDK. Pak přejděte do složky iothub\device\samples\getting started\SimulatedDeviceWithCommand .

  2. Spuštěním následujícího příkazu nainstalujte požadované balíčky pro aplikaci simulovaného zařízení:

    dotnet restore
    
  3. Spuštěním následujícího příkazu sestavte a spusťte aplikaci simulovaného zařízení.

    {DeviceConnectionString}: Nahraďte tento zástupný symbol připojovacím řetězcem zařízení, který jste si poznamenali dříve.

    dotnet run -- -c "{DeviceConnectionString}"
    

    Následující snímek obrazovky ukazuje výstup, zatímco aplikace simulovaného zařízení odesílá telemetrická data do vašeho centra IoT:

    Snímek obrazovky okna terminálu zobrazující výstup aplikace simulovaného zařízení

Zavolejte přímou metodu

Aplikační služba se připojí ke koncovému bodu na straně služby vašeho IoT Hubu. Aplikace provádí přímé volání metod na zařízení prostřednictvím centra IoT a čeká na potvrzení. Aplikace služby IoT Hub se obvykle spouští v cloudu.

  1. V jiném okně místního terminálu přejděte do kořenové složky sady SDK. Pak přejděte do složky iothub\service\samples\getting started\InvokeDeviceMethod .

  2. V okně místního terminálu spusťte následující příkazy pro instalaci požadovaných knihoven pro aplikaci služby:

    dotnet build
    
  3. V okně místního terminálu spusťte následující příkazy, které sestaví a spustí aplikaci služby.

    {ServiceConnectionString}: Nahraďte tento zástupný text připojovacím řetězcem služby IoT Hub, který jste si poznamenali dříve.

    {DeviceName}: Nahraďte tento zástupný symbol názvem zařízení, které jste zaregistrovali.

    dotnet run -- -c "{ServiceConnectionString}" -d {DeviceName}
    

    Následující snímek obrazovky ukazuje výstup, když aplikace provádí přímou metodu na zařízení a přijímá potvrzení:

    Snímek obrazovky okna terminálu zobrazující výsledek volání přímé metody z aplikace služby

    Po spuštění aplikace služby se v okně místního terminálu, kde běží simulované zařízení, zobrazí zpráva a tempo, kterým odesílá zprávy, se změní.

    Snímek obrazovky okna terminálu zobrazující výsledek přímé zprávy a aktualizovaný výstup z aplikace simulovaného zařízení

V tomto rychlém startu se používají dvě aplikace v Javě:

  • Aplikace simulovaného zařízení, která reaguje na přímé metody volané z back-endové aplikace.
  • Aplikace pro služby, která volá přímou metodu na simulovaném zařízení.

Požadavky

Poznámka:

Tento článek používá nejnovější verzi rozšíření Azure IoT, která se nazývá azure-iot. Starší verze se nazývá azure-cli-iot-ext. Najednou byste měli mít nainstalovanou jenom jednu verzi. K ověření aktuálně nainstalovaných rozšíření můžete použít příkaz az extension list.

Pomocí az extension remove --name azure-cli-iot-ext odeberte starší verzi rozšíření.

Pomocí az extension add --name azure-iot přidejte novou verzi rozšíření.

Chcete-li zjistit, jaká rozšíření jsou aktuálně nainstalována, použijte az extension list.

Vytvoření ioT Hubu

V této části použijete Azure CLI k vytvoření centra IoT a skupiny prostředků. Skupina prostředků Azure je logický kontejner, ve kterém se nasazují a spravují prostředky Azure. Centrum IoT funguje jako centrální centrum zpráv pro obousměrnou komunikaci mezi vaší aplikací IoT a zařízeními.

Pokud už ve svém předplatném Azure máte centrum IoT, můžete tuto část přeskočit.

Chcete-li vytvořit centrum IoT a skupinu prostředků:

  1. Spusťte aplikaci příkazového řádku (CLI). Pokud chcete spustit příkazy rozhraní příkazového řádku ve zbývající části tohoto článku, zkopírujte syntaxi příkazu, vložte ho do aplikace CLI, upravte hodnoty proměnných a stiskněte Enter.

    • Pokud používáte Cloud Shell, vyberte v příkazech rozhraní příkazového řádku tlačítko Vyzkoušet a spusťte Cloud Shell v rozděleném okně prohlížeče. Nebo můžete Cloud Shell otevřít na samostatné kartě prohlížeče.
    • Pokud používáte Azure CLI místně, spusťte konzolovou aplikaci CLI a přihlaste se k Azure CLI.
  2. Spuštěním příkazu az extension add nainstalujte nebo upgradujte rozšíření azure-iot na aktuální verzi.

    az extension add --upgrade --name azure-iot
    
  3. V aplikaci CLI spusťte příkaz az group create k vytvoření skupiny prostředků. Následující příkaz vytvoří skupinu prostředků s názvem MyResourceGroup ve umístění eastus.

    Poznámka:

    Volitelně můžete nastavit jiné umístění. Pokud chcete zobrazit dostupná umístění, spusťte az account list-locationspříkaz . V tomto rychlém startu se používá eastus , jak je znázorněno v ukázkovém příkazu.

    az group create --name MyResourceGroup --location eastus
    
  4. Spuštěním příkazu az iot hub create vytvořte IoT Hub. Vytvoření centra IoT může trvat několik minut.

    YourIoTHubName. Nahraďte tento zástupný symbol a okolní složené závorky v následujícím příkazu pomocí názvu, který jste zvolili pro centrum IoT. Název centra IoT musí být v Azure globálně jedinečný. Ve zbývající části tohoto rychlého spuštění použijte název svého centra IoT, kdykoli vidíte zástupný symbol.

    az iot hub create --resource-group MyResourceGroup --name {YourIoTHubName}
    

Registrace zařízení

Zařízení musí být zaregistrované ve vašem centru IoT Hub, aby se mohlo připojit. V této části použijete Azure CLI k vytvoření identity zařízení.

Pokud už máte zařízení zaregistrované ve službě IoT Hub, můžete tuto část přeskočit.

Vytvoření identity zařízení:

  1. V prostředí CLI spusťte příkaz az iot hub device-identity create. Tento příkaz vytvoří identitu zařízení.

    YourIoTHubName. Nahraďte tento zástupný symbol a okolní složené závorky v následujícím příkazu pomocí názvu, který jste zvolili pro centrum IoT. Název centra IoT musí být v Azure globálně jedinečný.

    myDevice. Tento název můžete použít pro ID zařízení v tomto článku nebo zadat jiný název zařízení.

    az iot hub device-identity create --device-id myDevice --hub-name {YourIoTHubName}
    
  2. Spusťte příkaz az iot hub device-identity connection-string show.

    az iot hub device-identity connection-string show --device-id myDevice --hub-name {YourIoTHubName}
    

    Výstup připojovacího řetězce je v následujícím formátu:

    HostName=<your IoT Hub name>.azure-devices.net;DeviceId=<your device id>;SharedAccessKey=<some value>
    
  3. Uložte připojovací řetězec do zabezpečeného umístění.

Poznámka:

Nechte aplikaci rozhraní příkazového řádku otevřenou. Použijete ho v dalších krocích.

Načtení připojovacího řetězce služby

Potřebujete také připojovací řetězec služby , který back-endové aplikaci umožní připojit se k centru IoT a načíst zprávy. Následující příkaz načte řetězec připojení pro váš IoT hub:

YourIoTHubName: Nahraďte tento zástupný symbol v následujícím příkazu názvem, který jste zvolili pro centrum IoT.

az iot hub connection-string show --policy-name service --hub-name {YourIoTHubName} --output table

Poznamenejte si připojovací řetězec služby, který vypadá takto:

HostName={YourIoTHubName}.azure-devices.net;SharedAccessKeyName=service;SharedAccessKey={YourSharedAccessKey}

Tuto hodnotu použijete později v rychlém startu. Tento připojovací řetězec služby se liší od připojovacího řetězce zařízení, který jste si poznamenali v předchozím kroku.

Simulace zařízení

Aplikace simulovaného zařízení se připojí ke koncovému bodu specifickému pro zařízení ve vašem centru IoT, odešle simulovanou telemetrii a naslouchá volání přímých metod z vašeho centra. V tomto rychlém startu příkaz přímé metody z centra instruuje zařízení, aby nastavilo na nový interval, ve kterém odesílá telemetrii. Simulované zařízení odešle potvrzení zpět do centra poté, co spustí přímou metodu.

  1. V okně místního terminálu přejděte do kořenové složky ukázkového projektu Java. Pak přejděte do složky iot-hub\Quickstarts\simulated-device-2 .

  2. Otevřete soubor src/main/java/com/microsoft/docs/iothub/samples/SimulatedDevice.java v textovém editoru podle vašeho výběru.

    connString Hodnotu proměnné nahraďte připojovacím řetězcem zařízení, který jste si poznamenali dříve. Potom uložte změny do SimulatedDevice.java.

  3. V okně místního terminálu spusťte následující příkazy pro instalaci požadovaných knihoven a sestavení aplikace simulovaného zařízení:

    mvn clean package
    
  4. V okně místního terminálu spusťte následující příkazy pro spuštění aplikace simulovaného zařízení:

    java -jar target/simulated-device-2-1.0.0-with-deps.jar
    

    Následující snímek obrazovky ukazuje výstup, zatímco aplikace simulovaného zařízení odesílá telemetrická data do vašeho centra IoT:

    Snímek obrazovky okna terminálu zobrazující výstup aplikace simulovaného zařízení

Zavolejte přímou metodu

Back-endová aplikace se připojí ke koncovému bodu na straně serveru v IoT Hub. Aplikace provádí přímé volání metod na zařízení prostřednictvím centra IoT a čeká na potvrzení. Back-endová aplikace IoT Hubu se obvykle spouští v cloudu.

  1. V jiném okně místního terminálu přejděte do kořenové složky ukázkového projektu Java. Pak přejděte do složky iot-hub\Quickstarts\back-end-application .

  2. Otevřete soubor src/main/java/com/microsoft/docs/iothub/samples/BackEndApplication.java v textovém editoru podle vašeho výběru.

    iotHubConnectionString Hodnotu proměnné nahraďte připojovacím řetězcem služby, který jste si poznamenali dříve. Změny pak uložte do BackEndApplication.java.

  3. V okně místního terminálu spusťte následující příkazy pro instalaci požadovaných knihoven a sestavení back-endové aplikace:

    mvn clean package
    
  4. V okně místního terminálu spusťte následující příkazy pro spuštění back-endové aplikace:

    java -jar target/back-end-application-1.0.0-with-deps.jar
    

    Následující snímek obrazovky ukazuje výstup, když aplikace provádí přímou metodu na zařízení a přijímá potvrzení:

    Snímek obrazovky okna terminálu zobrazující výsledek volání přímé metody z aplikace služby

    Po spuštění back-endové aplikace se v okně místního terminálu se simulovaným zařízením zobrazí zpráva a rychlost odesílání zpráv se změní:

    Snímek obrazovky okna terminálu zobrazující výsledek přímé zprávy a aktualizovaný výstup z aplikace simulovaného zařízení

V tomto rychlém startu se používají dvě Node.js aplikace:

  • Aplikace simulovaného zařízení, která reaguje na přímé metody volané z back-endové aplikace. Pro příjem volání přímé metody se tato aplikace připojí ke koncovému bodu specifickému pro zařízení ve vašem centru IoT.
  • Back-endová aplikace, která volá přímé metody na simulovaném zařízení. Pokud chcete na zařízení volat přímou metodu, připojí se tato aplikace ke koncovému bodu specifickému pro službu ve vašem centru IoT.

Požadavky

Poznámka:

Tento článek používá nejnovější verzi rozšíření Azure IoT, která se nazývá azure-iot. Starší verze se nazývá azure-cli-iot-ext. Najednou byste měli mít nainstalovanou jenom jednu verzi. K ověření aktuálně nainstalovaných rozšíření můžete použít příkaz az extension list.

Pomocí az extension remove --name azure-cli-iot-ext odeberte starší verzi rozšíření.

Pomocí az extension add --name azure-iot přidejte novou verzi rozšíření.

Chcete-li zjistit, jaká rozšíření jsou aktuálně nainstalována, použijte az extension list.

Vytvoření ioT Hubu

V této části použijete Azure CLI k vytvoření centra IoT a skupiny prostředků. Skupina prostředků Azure je logický kontejner, ve kterém se nasazují a spravují prostředky Azure. Centrum IoT funguje jako centrální centrum zpráv pro obousměrnou komunikaci mezi vaší aplikací IoT a zařízeními.

Pokud už ve svém předplatném Azure máte centrum IoT, můžete tuto část přeskočit.

Chcete-li vytvořit centrum IoT a skupinu prostředků:

  1. Spusťte aplikaci příkazového řádku (CLI). Pokud chcete spustit příkazy rozhraní příkazového řádku ve zbývající části tohoto článku, zkopírujte syntaxi příkazu, vložte ho do aplikace CLI, upravte hodnoty proměnných a stiskněte Enter.

    • Pokud používáte Cloud Shell, vyberte v příkazech rozhraní příkazového řádku tlačítko Vyzkoušet a spusťte Cloud Shell v rozděleném okně prohlížeče. Nebo můžete Cloud Shell otevřít na samostatné kartě prohlížeče.
    • Pokud používáte Azure CLI místně, spusťte konzolovou aplikaci CLI a přihlaste se k Azure CLI.
  2. Spuštěním příkazu az extension add nainstalujte nebo upgradujte rozšíření azure-iot na aktuální verzi.

    az extension add --upgrade --name azure-iot
    
  3. V aplikaci CLI spusťte příkaz az group create k vytvoření skupiny prostředků. Následující příkaz vytvoří skupinu prostředků s názvem MyResourceGroup ve umístění eastus.

    Poznámka:

    Volitelně můžete nastavit jiné umístění. Pokud chcete zobrazit dostupná umístění, spusťte az account list-locationspříkaz . V tomto rychlém startu se používá eastus , jak je znázorněno v ukázkovém příkazu.

    az group create --name MyResourceGroup --location eastus
    
  4. Spuštěním příkazu az iot hub create vytvořte IoT Hub. Vytvoření centra IoT může trvat několik minut.

    YourIoTHubName. Nahraďte tento zástupný symbol a okolní složené závorky v následujícím příkazu pomocí názvu, který jste zvolili pro centrum IoT. Název centra IoT musí být v Azure globálně jedinečný. Ve zbývající části tohoto rychlého spuštění použijte název svého centra IoT, kdykoli vidíte zástupný symbol.

    az iot hub create --resource-group MyResourceGroup --name {YourIoTHubName}
    

Registrace zařízení

Zařízení musí být zaregistrované ve vašem centru IoT Hub, aby se mohlo připojit. V této části použijete Azure CLI k vytvoření identity zařízení.

Pokud už máte zařízení zaregistrované ve službě IoT Hub, můžete tuto část přeskočit.

Vytvoření identity zařízení:

  1. V prostředí CLI spusťte příkaz az iot hub device-identity create. Tento příkaz vytvoří identitu zařízení.

    YourIoTHubName. Nahraďte tento zástupný symbol a okolní složené závorky v následujícím příkazu pomocí názvu, který jste zvolili pro centrum IoT. Název centra IoT musí být v Azure globálně jedinečný.

    myDevice. Tento název můžete použít pro ID zařízení v tomto článku nebo zadat jiný název zařízení.

    az iot hub device-identity create --device-id myDevice --hub-name {YourIoTHubName}
    
  2. Spusťte příkaz az iot hub device-identity connection-string show.

    az iot hub device-identity connection-string show --device-id myDevice --hub-name {YourIoTHubName}
    

    Výstup připojovacího řetězce je v následujícím formátu:

    HostName=<your IoT Hub name>.azure-devices.net;DeviceId=<your device id>;SharedAccessKey=<some value>
    
  3. Uložte připojovací řetězec do zabezpečeného umístění.

Poznámka:

Nechte aplikaci rozhraní příkazového řádku otevřenou. Použijete ho v dalších krocích.

Načtení připojovacího řetězce služby

Také potřebujete připojovací řetězec služby vašeho IoT hubu, aby se back-endová aplikace mohla připojit k vašemu IoT hubu a načíst zprávy. Následující příkaz načte řetězec připojení pro váš IoT hub:

YourIoTHubName: Nahraďte tento zástupný symbol v následujícím příkazu názvem, který jste zvolili pro centrum IoT.

az iot hub connection-string show \
  --policy-name service --hub-name {YourIoTHubName} --output table

Poznamenejte si připojovací řetězec služby, který vypadá takto:

HostName={YourIoTHubName}.azure-devices.net;SharedAccessKeyName=service;SharedAccessKey={YourSharedAccessKey}

Tuto hodnotu použijete později v rychlém startu. Tento připojovací řetězec služby se liší od připojovacího řetězce zařízení, který jste si poznamenali v předchozím kroku.

Simulace zařízení

Aplikace simulovaného zařízení se připojí ke koncovému bodu specifickému pro zařízení ve vašem centru IoT, odešle simulovanou telemetrii a naslouchá volání přímých metod z vašeho centra. V tomto rychlém startu příkaz přímé metody z centra instruuje zařízení, aby nastavilo na nový interval, ve kterém odesílá telemetrii. Simulované zařízení odešle potvrzení zpět do centra poté, co spustí přímou metodu.

  1. V okně místního terminálu přejděte do kořenové složky ukázkového projektu Node.js. Pak přejděte do složky iot-hub\Quickstarts\simulated-device-2 .

  2. Otevřete souborSimulatedDevice.js v textovém editoru podle svého výběru.

    connectionString Hodnotu proměnné nahraďte připojovacím řetězcem zařízení, který jste si poznamenali dříve. Potom uložte změny do SimulatedDevice.js.

  3. V okně místního terminálu spusťte následující příkazy, které nainstalují požadované knihovny a spustí aplikaci simulovaného zařízení:

    npm install
    node SimulatedDevice.js
    

    Následující snímek obrazovky ukazuje výstup, zatímco aplikace simulovaného zařízení odesílá telemetrická data do vašeho centra IoT:

    Snímek obrazovky okna terminálu zobrazující výstup aplikace simulovaného zařízení

Zavolejte přímou metodu

Back-endová aplikace se připojí ke koncovému bodu na straně služby ve vašem centru IoT. Aplikace provádí přímé volání metod na zařízení prostřednictvím centra IoT a čeká na potvrzení. Back-endová aplikace IoT Hubu se obvykle spouští v cloudu.

  1. V jiném okně místního terminálu přejděte do kořenové složky ukázkového projektu Node.js. Pak přejděte do složky iot-hub\Quickstarts\back-end-application .

  2. Otevřete souborBackEndApplication.js v textovém editoru podle svého výběru.

    connectionString Hodnotu proměnné nahraďte připojovacím řetězcem služby, který jste si poznamenali dříve. Potom uložte změny do BackEndApplication.js.

  3. V okně místního terminálu spusťte následující příkazy pro instalaci požadovaných knihoven a spuštění back-endové aplikace:

    npm install
    node BackEndApplication.js
    

    Následující snímek obrazovky ukazuje výstup, když aplikace provádí přímou metodu na zařízení a přijímá potvrzení:

    Snímek obrazovky okna terminálu zobrazující výsledek volání přímé metody z aplikace služby

    Po spuštění back-endové aplikace se v okně místního terminálu se simulovaným zařízením zobrazí zpráva a rychlost odesílání zpráv se změní:

    Snímek obrazovky okna terminálu zobrazující výsledek přímé zprávy a aktualizovaný výstup z aplikace simulovaného zařízení

V tomto rychlém startu se používají dvě aplikace Pythonu:

  • Aplikace simulovaného zařízení, která reaguje na přímé metody volané z back-endové aplikace.
  • Back-endová aplikace, která volá přímé metody na simulovaném zařízení.

Požadavky

Poznámka:

Tento článek používá nejnovější verzi rozšíření Azure IoT, která se nazývá azure-iot. Starší verze se nazývá azure-cli-iot-ext. Najednou byste měli mít nainstalovanou jenom jednu verzi. K ověření aktuálně nainstalovaných rozšíření můžete použít příkaz az extension list.

Pomocí az extension remove --name azure-cli-iot-ext odeberte starší verzi rozšíření.

Pomocí az extension add --name azure-iot přidejte novou verzi rozšíření.

Chcete-li zjistit, jaká rozšíření jsou aktuálně nainstalována, použijte az extension list.

Vytvoření ioT Hubu

V této části použijete Azure CLI k vytvoření centra IoT a skupiny prostředků. Skupina prostředků Azure je logický kontejner, ve kterém se nasazují a spravují prostředky Azure. Centrum IoT funguje jako centrální centrum zpráv pro obousměrnou komunikaci mezi vaší aplikací IoT a zařízeními.

Pokud už ve svém předplatném Azure máte centrum IoT, můžete tuto část přeskočit.

Chcete-li vytvořit centrum IoT a skupinu prostředků:

  1. Spusťte aplikaci příkazového řádku (CLI). Pokud chcete spustit příkazy rozhraní příkazového řádku ve zbývající části tohoto článku, zkopírujte syntaxi příkazu, vložte ho do aplikace CLI, upravte hodnoty proměnných a stiskněte Enter.

    • Pokud používáte Cloud Shell, vyberte v příkazech rozhraní příkazového řádku tlačítko Vyzkoušet a spusťte Cloud Shell v rozděleném okně prohlížeče. Nebo můžete Cloud Shell otevřít na samostatné kartě prohlížeče.
    • Pokud používáte Azure CLI místně, spusťte konzolovou aplikaci CLI a přihlaste se k Azure CLI.
  2. Spuštěním příkazu az extension add nainstalujte nebo upgradujte rozšíření azure-iot na aktuální verzi.

    az extension add --upgrade --name azure-iot
    
  3. V aplikaci CLI spusťte příkaz az group create k vytvoření skupiny prostředků. Následující příkaz vytvoří skupinu prostředků s názvem MyResourceGroup ve umístění eastus.

    Poznámka:

    Volitelně můžete nastavit jiné umístění. Pokud chcete zobrazit dostupná umístění, spusťte az account list-locationspříkaz . V tomto rychlém startu se používá eastus , jak je znázorněno v ukázkovém příkazu.

    az group create --name MyResourceGroup --location eastus
    
  4. Spuštěním příkazu az iot hub create vytvořte IoT Hub. Vytvoření centra IoT může trvat několik minut.

    YourIoTHubName. Nahraďte tento zástupný symbol a okolní složené závorky v následujícím příkazu pomocí názvu, který jste zvolili pro centrum IoT. Název centra IoT musí být v Azure globálně jedinečný. Ve zbývající části tohoto rychlého spuštění použijte název svého centra IoT, kdykoli vidíte zástupný symbol.

    az iot hub create --resource-group MyResourceGroup --name {YourIoTHubName}
    

Registrace zařízení

Zařízení musí být zaregistrované ve vašem centru IoT Hub, aby se mohlo připojit. V této části použijete Azure CLI k vytvoření identity zařízení.

Pokud už máte zařízení zaregistrované ve službě IoT Hub, můžete tuto část přeskočit.

Vytvoření identity zařízení:

  1. V prostředí CLI spusťte příkaz az iot hub device-identity create. Tento příkaz vytvoří identitu zařízení.

    YourIoTHubName. Nahraďte tento zástupný symbol a okolní složené závorky v následujícím příkazu pomocí názvu, který jste zvolili pro centrum IoT. Název centra IoT musí být v Azure globálně jedinečný.

    myDevice. Tento název můžete použít pro ID zařízení v tomto článku nebo zadat jiný název zařízení.

    az iot hub device-identity create --device-id myDevice --hub-name {YourIoTHubName}
    
  2. Spusťte příkaz az iot hub device-identity connection-string show.

    az iot hub device-identity connection-string show --device-id myDevice --hub-name {YourIoTHubName}
    

    Výstup připojovacího řetězce je v následujícím formátu:

    HostName=<your IoT Hub name>.azure-devices.net;DeviceId=<your device id>;SharedAccessKey=<some value>
    
  3. Uložte připojovací řetězec do zabezpečeného umístění.

Poznámka:

Nechte aplikaci rozhraní příkazového řádku otevřenou. Použijete ho v dalších krocích.

Načtení připojovacího řetězce služby

Potřebujete také připojovací řetězec služby , který back-endové aplikaci umožní připojit se k centru IoT a načíst zprávy. Následující příkaz načte řetězec připojení pro váš IoT hub:

YourIoTHubName: Nahraďte tento zástupný symbol v následujícím příkazu názvem, který zvolíte pro centrum IoT.

az iot hub connection-string show \
  --policy-name service \
  --hub-name {YourIoTHubName} \
  --output table

Poznamenejte si připojovací řetězec služby, který vypadá takto:

HostName={YourIoTHubName}.azure-devices.net;SharedAccessKeyName=service;SharedAccessKey={YourSharedAccessKey}

Tuto hodnotu použijete později v rychlém startu. Tento připojovací řetězec služby se liší od připojovacího řetězce zařízení, který jste si poznamenali v předchozím kroku.

Simulace zařízení

Aplikace simulovaného zařízení se připojí ke koncovému bodu specifickému pro zařízení ve vašem centru IoT, odešle simulovanou telemetrii a naslouchá volání přímých metod z vašeho centra. V tomto rychlém startu příkaz přímé metody z centra instruuje zařízení, aby nastavilo na nový interval, ve kterém odesílá telemetrii. Simulované zařízení odešle potvrzení zpět do centra poté, co spustí přímou metodu.

  1. V okně místního terminálu přejděte do kořenové složky ukázkového projektu Pythonu. Pak přejděte do složky iot-hub\Quickstarts\simulated-device-2 .

  2. Otevřete soubor SimulatedDeviceSync.py v textovém editoru podle svého výběru.

    CONNECTION_STRING Hodnotu proměnné nahraďte připojovacím řetězcem zařízení, který jste si poznamenali dříve. Potom uložte změny do SimulatedDeviceSync.py.

  3. V okně místního terminálu spusťte následující příkazy pro instalaci požadovaných knihoven pro aplikaci simulovaného zařízení:

    pip install azure-iot-device
    
  4. V okně místního terminálu spusťte následující příkazy pro spuštění aplikace simulovaného zařízení:

    python SimulatedDeviceSync.py
    

    Následující snímek obrazovky ukazuje výstup, zatímco aplikace simulovaného zařízení odesílá telemetrická data do vašeho centra IoT:

    Snímek obrazovky okna terminálu zobrazující výstup aplikace simulovaného zařízení

Zavolejte přímou metodu

Back-endová aplikace se připojí ke koncovému bodu na straně serveru v IoT Hub. Aplikace provádí přímé volání metod na zařízení prostřednictvím centra IoT a čeká na potvrzení. Back-endová aplikace IoT Hubu se obvykle spouští v cloudu.

  1. V jiném okně místního terminálu přejděte do kořenové složky ukázkového projektu Pythonu. Pak přejděte do složky iot-hub\Quickstarts\back-end-application .

  2. Otevřete soubor BackEndApplication.py v textovém editoru podle vašeho výběru.

    CONNECTION_STRING Hodnotu proměnné nahraďte připojovacím řetězcem služby, který jste si poznamenali dříve. Změny pak uložte do BackEndApplication.py.

  3. V okně místního terminálu spusťte následující příkazy pro instalaci požadovaných knihoven pro aplikaci simulovaného zařízení:

    pip install azure-iot-hub
    
  4. V okně místního terminálu spusťte následující příkazy pro spuštění back-endové aplikace:

    python BackEndApplication.py
    

    Následující snímek obrazovky ukazuje výstup, když aplikace provádí přímou metodu na zařízení a přijímá potvrzení:

    Snímek obrazovky okna terminálu zobrazující výsledek volání přímé metody z aplikace služby

    Po spuštění back-endové aplikace se v konzolovém okně simulovaného zařízení zobrazí zpráva a míra, s jakou odesílá zprávy, se změní:

    Snímek obrazovky okna terminálu zobrazující výsledek přímé zprávy a aktualizovaný výstup z aplikace simulovaného zařízení

Uklidit zdroje

Pokud budete pokračovat k dalšímu doporučenému článku, můžete zachovat prostředky, které jste už vytvořili, a znovu je použít.

Jinak můžete odstranit prostředky Azure vytvořené v tomto článku, abyste se vyhnuli poplatkům.

Důležité

Odstranění skupiny prostředků je nevratné. Skupina prostředků i všechny prostředky v ní obsažené se trvale odstraní. Ujistěte se, že omylem nesmažete špatnou skupinu prostředků nebo jednotlivé prostředky. Pokud jste centrum IoT vytvořili v existující skupině prostředků, která obsahuje prostředky, které chcete zachovat, odstraňte místo odstranění skupiny prostředků samotný prostředek IoT Hubu.

Odstranit skupinu prostředků podle názvu:

  1. Přihlaste se k webu Azure Portal a potom vyberte Skupiny prostředků.

  2. Do pole Filtr pro libovolné textové pole zadejte název skupiny prostředků obsahující vaši službu IoT Hub.

  3. V seznamu výsledků vyberte skupinu prostředků obsahující vaši službu IoT Hub.

  4. V pracovním podokně skupiny prostředků vyberte na panelu příkazů Odstranit skupinu prostředků.

    Snímek obrazovky znázorňující pracovní podokno skupiny prostředků na webu Azure Portal se zvýrazněným příkazem Odstranit skupinu prostředků na panelu příkazů

  5. Zobrazí se výzva k potvrzení odstranění skupiny prostředků. Znovu zadejte název skupiny prostředků, abyste ji potvrdili, a pak vyberte Odstranit. Za pár okamžiků budou skupina prostředků a všechny v ní obsažené prostředky odstraněny.

Další kroky

V tomto rychlém startu jste volali přímou metodu na zařízení z aplikace služby a odpověděli na volání přímé metody v aplikaci simulovaného zařízení.

Abyste se naučili, jak směrovat zprávy ze zařízení do cloudu do různých cílů v cloudu, pokračujte dalším tutoriálem.