Oktatóanyag: Környezet beállítása az IoT Plug and Play gyorsútmutatóihoz és oktatóanyagaihoz
Mielőtt elvégezheti az IoT Plug and Play gyorsútmutatóit és oktatóanyagait, konfigurálnia kell egy IoT Hubot és a Device Provisioning Service-t (DPS) az Azure-előfizetésében. Szüksége lesz a mintaalkalmazások és az Azure IoT Explorer eszköz által használt modellfájlok helyi másolatára is.
Előfeltételek
Ha még nincs Azure-előfizetése, kezdés előtt hozzon létre egy ingyenes fiókot.
A környezet előkészítése az Azure CLI-hez
Használja a Bash-környezetet az Azure Cloud Shellben. További információ: A Bash rövid útmutatója az Azure Cloud Shellben.
Ha inkább helyi cli-referenciaparancsokat szeretne futtatni, telepítse az Azure CLI-t. Ha Windows vagy macOS rendszert használ, fontolja meg az Azure CLI Docker-tárolóban való futtatását. További információ: Az Azure CLI futtatása Docker-tárolóban.
Ha helyi telepítést használ, jelentkezzen be az Azure CLI-be az az login parancs futtatásával. A hitelesítési folyamat befejezéséhez kövesse a terminálon megjelenő lépéseket. További bejelentkezési lehetőségekért lásd : Bejelentkezés az Azure CLI-vel.
Amikor a rendszer kéri, először telepítse az Azure CLI-bővítményt. További információ a bővítményekről: Bővítmények használata az Azure CLI-vel.
Futtassa az az version parancsot a telepített verzió és a függő kódtárak megkereséséhez. A legújabb verzióra az az upgrade paranccsal frissíthet.
Az erőforrások létrehozása
Azure-erőforráscsoport létrehozása az erőforrásokhoz:
az group create --name my-pnp-resourcegroup --location centralus
IoT Hub létrehozása. Az alábbi parancs a nevet my-pnp-hub használja példaként az IoT Hub létrehozásához. Válasszon egyedi nevet az IoT Hubnak a következő helyett my-pnp-hub:
az iot hub create --name my-pnp-hub --resource-group my-pnp-resourcegroup --sku F1 --partition-count 2
HOZZon létre egy DPS-példányt. A következő parancs példaként használja a dps-példány my-pnp-dps nevét a létrehozáshoz. Válasszon egyedi nevet a DPS-példánynak a következő helyett my-pnp-dps:
az iot dps create --name my-pnp-dps --resource-group my-pnp-resourcegroup
A DPS-példány IoT Hubhoz való csatolásához használja az alábbi parancsokat. Cserélje le és my-pnp-hub írja be my-pnp-dps a korábban kiválasztott egyedi neveket:
hubConnectionString=$(az iot hub connection-string show -n my-pnp-hub --key primary --query connectionString -o tsv)
az iot dps linked-hub create --dps-name my-pnp-dps --resource-group my-pnp-resourcegroup --location centralus --connection-string $hubConnectionString
A beállítások lekérése
Néhány rövid útmutató és oktatóanyag az IoT Hub kapcsolati sztring használja. Az Azure IoT Explorer eszköz beállításakor szükség van a kapcsolati sztring is. Kérje le a kapcsolati sztring, és jegyezze fel most. Cserélje le my-pnp-hub az IoT Hubhoz választott egyedi nevet:
az iot hub connection-string show -n my-pnp-hub --key primary --query connectionString
A rövid útmutatók és oktatóanyagok többsége a DPS-konfiguráció azonosító hatókörét használja. Kérje le az azonosító hatókörét, és jegyezze fel most. Cserélje le my-pnp-dps a DPS-példányhoz választott egyedi nevet:
az iot dps show --name my-pnp-dps --query properties.idScope
Az összes rövid útmutató és oktatóanyag DPS-eszközregisztrációt használ. Az alábbi paranccsal hozhat létre egyéni eszközregisztrációt my-pnp-device a DPS-példányban. Cserélje le my-pnp-dps a DPS-példányhoz választott egyedi nevet. Jegyezze fel a rövid útmutatókban és oktatóanyagokban használandó regisztrációs azonosítót és elsődleges kulcsértékeket:
az iot dps enrollment create --attestation-type symmetrickey --dps-name my-pnp-dps --resource-group my-pnp-resourcegroup --enrollment-id my-pnp-device --device-id my-pnp-device --query '{registrationID:registrationId,primaryKey:attestation.symmetricKey.primaryKey}'
Környezeti változók létrehozása
Hozzon létre öt környezeti változót, hogy a rövid útmutatókban és oktatóanyagokban szereplő mintákat konfigurálja a Device Provisioning Service (DPS) használatával az IoT Hubhoz való csatlakozáshoz:
- IOTHUB_DEVICE_Standard kiadásCURITY_TYPE: az érték
DPS. - IOTHUB_DEVICE_DPS_ID_SCOPE: a korábban jegyzett DPS-azonosító hatóköre.
- IOTHUB_DEVICE_DPS_DEVICE_ID: az érték
my-pnp-device. - IOTHUB_DEVICE_DPS_DEVICE_KEY: a regisztrációs elsődleges kulcs, amelyről korábban megjegyzést tett.
- IOTHUB_DEVICE_DPS_ENDPOINT: az érték
global.azure-devices-provisioning.net
A szolgáltatásmintáknak a következő környezeti változókra van szükségük ahhoz, hogy azonosítsák a központot és az eszközt, amelyhez csatlakozni szeretnének:
- IOTHUB_CONNECTION_STRING: az IoT Hub kapcsolati sztring, amelyről korábban feljegyzést készített.
- IOTHUB_DEVICE_ID:
my-pnp-device.
Például linuxos bash-rendszerhéjban:
export IOTHUB_DEVICE_SECURITY_TYPE="DPS"
export IOTHUB_DEVICE_DPS_ID_SCOPE="<Your ID scope>"
export IOTHUB_DEVICE_DPS_DEVICE_ID="my-pnp-device"
export IOTHUB_DEVICE_DPS_DEVICE_KEY="<Your enrolment primary key>"
export IOTHUB_DEVICE_DPS_ENDPOINT="global.azure-devices-provisioning.net"
export IOTHUB_CONNECTION_STRING="<Your IoT hub connection string>"
export IOTHUB_DEVICE_ID="my-pnp-device"
Például a Windows parancssorában:
set IOTHUB_DEVICE_SECURITY_TYPE=DPS
set IOTHUB_DEVICE_DPS_ID_SCOPE=<Your ID scope>
set IOTHUB_DEVICE_DPS_DEVICE_ID=my-pnp-device
set IOTHUB_DEVICE_DPS_DEVICE_KEY=<Your enrolment primary key>
set IOTHUB_DEVICE_DPS_ENDPOINT=global.azure-devices-provisioning.net
set IOTHUB_CONNECTION_STRING=<Your IoT hub connection string>
set IOTHUB_DEVICE_ID=my-pnp-device
A modellfájlok letöltése
A rövid útmutatók és oktatóanyagok mintamodell-fájlokat használnak a hőmérséklet-vezérlőhöz és a termosztát-eszközökhöz. A mintamodell-fájlok letöltése:
Hozzon létre egy modellek nevű mappát a helyi gépen.
Kattintson a jobb gombbal a TemperatureController.json , és mentse a JSON-fájlt a Modellek mappába.
Kattintson a jobb gombbal a Thermostat.json , és mentse a JSON-fájlt a Modellek mappába.
Az Azure IoT Explorer telepítése
A rövid útmutatók és oktatóanyagok az Azure IoT Explorer eszközt használják. Nyissa meg az Azure IoT Explorer kiadásait, és bontsa ki a legújabb kiadáshoz tartozó eszközök listáját. Töltse le és telepítse az alkalmazás legújabb verzióját az operációs rendszerhez.
Az eszköz első futtatásakor a rendszer az IoT Hub kapcsolati sztring kéri. Használja a korábban jegyzett kapcsolati sztring.
Konfigurálja az eszközt a korábban letöltött modellfájlok használatára. Az eszköz kezdőlapján válassza az IoT Plug and Play Gépház, majd a Helyi mappa hozzáadása > lehetőséget. Válassza ki a korábban létrehozott modellek mappát. Ezután válassza a Mentés lehetőséget a beállítások mentéséhez.
További információ: Az Azure IoT Explorer telepítése és használata.
Az erőforrások eltávolítása
Az IoT Hub és a DPS-példány az összes IoT Plug and Play gyorsútmutatóhoz és oktatóanyaghoz használható, ezért csak egyszer kell elvégeznie a cikkben szereplő lépéseket. Ha végzett, a következő paranccsal távolíthatja el őket az előfizetésből:
az group delete --name my-pnp-resourcegroup
Következő lépések
Most, hogy beállította a környezetet, kipróbálhatja az alábbi rövid útmutatókat vagy oktatóanyagokat: