Sdílet prostřednictvím

Použití rozšíření IoT pro Azure CLI pro správu Azure IoT Hub zařízení

  • Článek

Kompletní diagram

V tomto článku se dozvíte, jak používat rozšíření IoT pro Azure CLI s různými možnostmi správy na vývojovém počítači. Rozšíření IoT pro Azure CLI je opensourcové rozšíření IoT, které přidává možnosti Azure CLI. Azure CLI obsahuje příkazy pro interakci s koncovými body azure Resource Manager a správy. Azure CLI můžete například použít k vytvoření virtuálního počítače Azure nebo centra IoT. Rozšíření rozhraní příkazového řádku umožňuje službě Azure rozšířit Azure CLI a získat tak přístup k dalším funkcím specifickým pro službu. Rozšíření IoT poskytuje vývojářům IoT přístup z příkazového řádku ke všem funkcím IoT Hub, IoT Edge a IoT Hub Device Provisioning.

Možnost správy Úkol
Přímé metody Nastavit, aby zařízení fungovalo, například spuštění nebo zastavení odesílání zpráv nebo restartování zařízení.
Požadované vlastnosti dvojčete Uveďte zařízení do určitých stavů, například nastavení indikátoru LED na zelenou nebo nastavení intervalu odesílání telemetrie na 30 minut.
Ohlášené vlastnosti dvojčete Získejte nahlášený stav zařízení. Zařízení například hlásí, že teď bliká kontrolka LED.
Značky dvojčat Uložte metadata specifická pro zařízení v cloudu. Například umístění nasazení prodejního počítače.
Dotazy dvojčat zařízení Dotazem na všechna dvojčata zařízení načtěte tato dvojčata s libovolnými podmínkami, jako je identifikace zařízení, která jsou k dispozici pro použití.

Podrobnější vysvětlení rozdílů a pokyny k používání těchto možností najdete v tématu Pokyny ke komunikaci mezi zařízeními a cloudem a Pokyny ke komunikaci z cloudu do zařízení.

Dvojčata zařízení jsou dokumenty JSON, které obsahují informace o stavu zařízení (metadata, konfigurace a podmínky). IoT Hub zachová dvojče zařízení pro každé zařízení, které se k němu připojuje. Další informace o dvojčatech zařízení najdete v tématu Začínáme s dvojčaty zařízení.

Poznámka

Tento článek používá nejnovější verzi rozšíření Azure IoT s názvem 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 .

Slouží az extension remove --name azure-cli-iot-ext k odebrání starší verze rozšíření.

Použijte az extension add --name azure-iot k přidání nové verze rozšíření.

Pokud chcete zjistit, jaká rozšíření máte nainstalovaná, použijte az extension list.

Poznámka

Funkce popsané v tomto článku jsou k dispozici pouze na úrovni Standard IoT Hub. Další informace o úrovních IoT Hub Basic a Standard/Free najdete v tématu Volba správné IoT Hub úrovně pro vaše řešení.

Požadavky

  • Dokončete kurz online simulátoru Raspberry Pi nebo jeden z kurzů zařízení. Můžete například přejít na Raspberry Pi pomocí Node.js nebo na některý z rychlých startů pro odesílání telemetrie . Tyto články popisují následující požadavky:

    • Musíte mít aktivní předplatné Azure.
    • Azure IoT Hub v rámci vašeho předplatného.
    • Klientská aplikace, která odesílá zprávy do služby Azure IoT Hub.

  • Během tohoto kurzu se ujistěte, že vaše zařízení běží s klientskou aplikací.

  • Python 2.7x nebo Python 3.x

  • The Azure CLI. Pokud ho potřebujete nainstalovat, přečtěte si téma Instalace Azure CLI. Minimálně musí být verze Azure CLI 2.0.70 nebo vyšší. Ke kontrole použijte příkaz az –version.

Poznámka

Tento článek používá nejnovější verzi rozšíření Azure IoT s názvem 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 .

Slouží az extension remove --name azure-cli-iot-ext k odebrání starší verze rozšíření.

Použijte az extension add --name azure-iot k přidání nové verze rozšíření.

Pokud chcete zjistit, jaká rozšíření máte nainstalovaná, použijte az extension list.

  • Nainstalujte rozšíření IoT. Nejjednodušším způsobem je spustit příkaz az extension add --name azure-iot. Soubor Readme rozšíření IoT obsahuje popis několika způsobů instalace rozšíření.

Přihlášení k účtu Azure

Přihlaste se ke svému účtu Azure spuštěním následujícího příkazu:

az login

Přímé metody

az iot hub invoke-device-method --device-id <your device id> \
  --hub-name <your hub name> \
  --method-name <the method name> \
  --method-payload <the method payload>

Požadované vlastnosti dvojčete zařízení

Spuštěním následujícího příkazu nastavte interval požadované vlastnosti = 3000:

az iot hub device-twin update -n <your hub name> \
  -d <your device id> --set properties.desired.interval=3000

Tato vlastnost se dá číst z vašeho zařízení.

Ohlášené vlastnosti dvojčete zařízení

Spuštěním následujícího příkazu získejte ohlášené vlastnosti zařízení:

az iot hub device-twin show -n <your hub name> -d <your device id>

Jedna z ohlášených vlastností dvojčete je $metadata.$lastUpdated, která ukazuje, kdy aplikace zařízení naposledy aktualizovala svou sadu ohlášených vlastností.

Značky dvojčat zařízení

Zobrazte značky a vlastnosti zařízení spuštěním následujícího příkazu:

az iot hub device-twin show --hub-name <your hub name> --device-id <your device id>

Spuštěním následujícího příkazu přidejte do zařízení roli pole = teplotní&vlhkost:

az iot hub device-twin update \
  --hub-name <your hub name> \
  --device-id <your device id> \
  --set tags='{"role":"temperature&humidity"}'

Dotazy dvojčat zařízení

Spuštěním následujícího příkazu zadejte dotaz na zařízení se značkou role = "teplota&vlhkosti":

az iot hub query --hub-name <your hub name> \
  --query-command "SELECT * FROM devices WHERE tags.role = 'temperature&humidity'"

Spuštěním následujícího příkazu se dotazujte na všechna zařízení s výjimkou zařízení se značkou role = 'temperature&humidity':

az iot hub query --hub-name <your hub name> \
  --query-command "SELECT * FROM devices WHERE tags.role != 'temperature&humidity'"

Další kroky

Naučili jste se, jak monitorovat zprávy zařízení-cloud a odesílat zprávy z cloudu do zařízení mezi zařízením IoT a Azure IoT Hub.

Pokud chcete pokračovat v začátcích s Azure IoT Hub a prozkoumat všechny rozšířené scénáře IoT, podívejte se na následující: