Dela via


Självstudie: Konfigurera din miljö för snabbstarter och självstudier för IoT Plug and Play

Innan du kan slutföra någon av snabbstarterna och självstudierna för IoT Plug and Play måste du konfigurera en IoT-hubb och Device Provisioning Service (DPS) i din Azure-prenumeration. Du behöver också lokala kopior av modellfilerna som används av exempelprogrammen och Azure IoT Explorer-verktyget.

Viktigt!

Den här artikeln innehåller steg för att ansluta till en tjänst med hjälp av en signatur för delad åtkomst. Den här autentiseringsmetoden är praktisk för testning och utvärdering, men autentisering till en tjänst med Microsoft Entra-ID eller hanterade identiteter är en säkrare metod. Mer information finns i Metodtips för > säkerhet Molnsäkerhet.

Förutsättningar

Om du inte har någon Azure-prenumeration skapar du ett kostnadsfritt konto innan du börjar.

Förbereda din miljö för Azure CLI

Skapa resurserna

Skapa en Azure-resursgrupp för resurserna:

az group create --name my-pnp-resourcegroup --location centralus

Skapa en IoT-hubb. Följande kommando använder namnet my-pnp-hub som ett exempel för namnet på IoT-hubben för att skapa. Välj ett unikt namn för din IoT-hubb som ska användas i stället my-pnp-hubför :

az iot hub create --name my-pnp-hub --resource-group my-pnp-resourcegroup --sku F1 --partition-count 2

Skapa en DPS-instans. Följande kommando använder namnet my-pnp-dps som ett exempel på namnet på DPS-instansen som ska skapas. Välj ett unikt namn för dps-instansen som ska användas i stället my-pnp-dpsför :

az iot dps create --name my-pnp-dps --resource-group my-pnp-resourcegroup

Om du vill länka DPS-instansen till din IoT-hubb använder du följande kommandon. Ersätt my-pnp-dps och my-pnp-hub med de unika namn som du valde tidigare:

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

Hämta inställningarna

Vissa snabbstarter och självstudier använder anslutningssträng för din IoT-hubb. Du behöver också anslutningssträng när du konfigurerar Azure IoT Explorer-verktyget. Hämta anslutningssträng och anteckna det nu. Ersätt my-pnp-hub med det unika namn som du valde för din IoT-hubb:

az iot hub connection-string show -n my-pnp-hub --key primary --query connectionString

De flesta av snabbstarterna och självstudierna använder ID-omfånget för DPS-konfigurationen. Hämta ID-omfånget och anteckna det nu. Ersätt my-pnp-dps med det unika namn som du valde för din DPS-instans:

az iot dps show --name my-pnp-dps --query properties.idScope

Alla snabbstarter och självstudier använder en DPS-enhetsregistrering. Använd följande kommando för att skapa en my-pnp-device enskild enhetsregistrering i din DPS-instans. Ersätt my-pnp-dps med det unika namn som du valde för din DPS-instans. Anteckna registrerings-ID:t och primärnyckelvärdena som ska användas i snabbstarterna och självstudierna:

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}'

Skapa miljövariabler

Skapa fem miljövariabler för att konfigurera exemplen i snabbstarterna och självstudierna för att använda Device Provisioning Service (DPS) för att ansluta till din IoT-hubb:

  • IOTHUB_DEVICE_SECURITY_TYPE: värdet DPS.
  • IOTHUB_DEVICE_DPS_ID_SCOPE: DPS-ID-omfånget som du antecknade tidigare.
  • IOTHUB_DEVICE_DPS_DEVICE_ID: värdet my-pnp-device.
  • IOTHUB_DEVICE_DPS_DEVICE_KEY: den primära registreringsnyckel som du antecknade tidigare.
  • IOTHUB_DEVICE_DPS_ENDPOINT: värdetglobal.azure-devices-provisioning.net

Tjänstexemplen behöver följande miljövariabler för att identifiera hubben och enheten som ska anslutas till:

  • IOTHUB_CONNECTION_STRING: IoT-hubben anslutningssträng du antecknade tidigare.
  • IOTHUB_DEVICE_ID: my-pnp-device.

Till exempel i ett Linux bash-gränssnitt:

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"

Till exempel på Windows-kommandoraden:

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

Ladda ned modellfilerna

Snabbstarterna och självstudierna använder exempelmodellfiler för temperaturstyrenheten och termostatenheterna. Så här laddar du ned exempelmodellfilerna:

  1. Skapa en mapp med namnet modeller på den lokala datorn.

  2. Högerklicka på TemperatureController.json och spara JSON-filen i mappen models .

  3. Högerklicka på Thermostat.json och spara JSON-filen i mappen models .

Installera Azure IoT Explorer

Snabbstarterna och självstudierna använder verktyget Azure IoT Explorer . Gå till Versioner av Azure IoT Explorer och expandera listan över tillgångar för den senaste versionen. Ladda ned och installera den senaste versionen av programmet för operativsystemet.

Första gången du kör verktyget uppmanas du att ange IoT Hub-anslutningssträng. Använd anslutningssträng som du antecknade tidigare.

Konfigurera verktyget så att det använder de modellfiler som du laddade ned tidigare. På startsidan i verktyget väljer du IoT Plug and Play-inställningar och sedan + Lägg till > lokal mapp. Välj den modellmapp som du skapade tidigare. Välj sedan Spara för att spara inställningarna.

Mer information finns i Installera och använda Azure IoT Explorer.

Rensa resurser

Du kan använda IoT Hub- och DPS-instansen för alla snabbstarter och självstudier för IoT Plug and Play, så du behöver bara slutföra stegen i den här artikeln en gång. När du är klar kan du ta bort dem från din prenumeration med följande kommando:

az group delete --name my-pnp-resourcegroup

Nästa steg

Nu när du har konfigurerat din miljö kan du prova någon av snabbstarterna eller självstudierna, till exempel: