Installera och använda Azure IoT Explorer

Azure IoT Explorer är ett grafiskt verktyg för att interagera med och enheter som är anslutna till din IoT-hubb. Den här artikeln fokuserar på att använda verktyget för att testa dina IoT Plug and Play enheter. När du har installerat verktyget på den lokala datorn kan du använda det för att ansluta till en hubb. Du kan använda verktyget för att visa telemetri som enheterna skickar, arbeta med enhetsegenskaper och anropa kommandon.

Den här artikeln visar hur du:

  • Installera och konfigurera Verktyget Azure IoT Explorer.
  • Använd verktyget för att interagera med och testa dina IoT Plug and Play enheter.

Mer allmän information om hur du använder verktyget finns i GitHub readme.

Om du vill använda Verktyget Azure IoT Explorer behöver du:

  • En Azure IoT-hubb. Det finns många sätt att lägga till en IoT-hubb i din Azure-prenumeration, till exempel skapa en IoT-hubb med hjälp av Azure CLI. Du behöver IoT Hub-anslutningssträngen för att köra Verktyget Azure IoT Explorer. Om du inte har någon Azure-prenumeration kan du skapa ett kostnadsfritt konto innan du börjar.
  • En enhet som är registrerad i din IoT-hubb. Du kan använda IoT Explorer för att skapa och hantera enhetsregistreringar i IoT Hub.

Installera Azure IoT Explorer

Gå till Versionerna av Azure IoT Explorer och expandera listan över tillgångar för den senaste versionen. Ladda ned och installera den senaste versionen av programmet.

Viktigt

Uppdatera till version 0.13.x för att matcha modeller från valfri lagringsplats baserat på https://github.com/Azure/iot-plugandplay-models

Använda Azure IoT Explorer

För en enhet kan du antingen ansluta din egen enhet eller använda en av de simulerade exempelenheterna. Några exempel på simulerade enheter som skrivits på olika språk finns i självstudien Anslut IoT-Plug and Play för att IoT Hub.

Anslut till hubben

Första gången du kör Azure IoT Explorer uppmanas du att ange IoT-hubbens anslutningssträng. När du har lagt till anslutningssträngen väljer du Anslut. Du kan använda verktygets inställningar för att växla till en annan IoT-hubb genom att uppdatera anslutningssträngen.

Modelldefinitionen för en IoT Plug and Play enhet lagras antingen på den offentliga lagringsplatsen, den anslutna enheten eller i en lokal mapp. Som standard letar verktyget efter modelldefinitionen på den offentliga lagringsplatsen och den anslutna enheten. Du kan lägga till och ta bort källor eller konfigurera prioriteten för källorna i Inställningar:

Så här lägger du till en källa:

  1. Gå till Start/IoT-Plug and Play Inställningar
  2. Välj Lägg till och välj din källa från en lagringsplats eller lokal mapp.

Så här tar du bort en källa:

  1. Gå till Start/IoT-Plug and Play Inställningar
  2. Hitta den källa som du vill ta bort.
  3. Välj X för att ta bort det.

Ändra källprioriteringar:

Du kan dra och släppa en av modelldefinitionskällorna till en annan rangordning i listan.

Visa enheter

När verktyget ansluter till din IoT-hubb visas sidan Enhetslista som visar de enhetsidentiteter som registrerats med din IoT-hubb. Du kan välja en post i listan om du vill se mer information.

På sidan Med listan Enheter kan du:

  • Välj Ny för att registrera en ny enhet med hubben. Ange sedan ett enhets-ID. Använd standardinställningarna för att automatiskt generera autentiseringsnycklar och aktivera anslutningen till hubben.
  • Välj en enhet och välj sedan Ta bort för att ta bort en enhetsidentitet. Granska enhetsinformationen innan du slutför den här åtgärden för att vara säker på att du tar bort rätt enhetsidentitet.

Interagera med en enhet

På sidan Enheter väljer du ett värde i kolumnen Enhets-ID för att visa informationssidan för den registrerade enheten. För varje enhet finns det två avsnitt: Enhet och Digital Twin.

Enhet

Det här avsnittet innehåller flikarna Enhetsidentitet, Enhetstvilling, Telemetri, Direktmetod, Moln-till-enhet-meddelande, Modulidentitet.

IoT Plug and Play komponenter

Om enheten är ansluten till hubben med hjälp av ett modell-ID visar verktyget fliken IoT-Plug and Play-komponenter där du kan se modell-ID:t.

Om modell-ID:t är tillgängligt i någon av de konfigurerade källorna – Offentlig lagringsplatsen eller Lokal mapp, visas listan över komponenter. Om du väljer en komponent visas tillgängliga egenskaper, kommandon och telemetri.

På sidan Komponent kan du visa skrivskyddade egenskaper, uppdatera skrivbara egenskaper, anropa kommandon och se telemetrimeddelanden som skapas av den här komponenten.

Visa komponenter i Azure IoT Explorer

Egenskaper

Visa egenskaper i Azure IoT Explorer

Du kan visa de skrivskyddade egenskaper som definierats i ett gränssnitt på fliken Egenskaper (skrivskyddade). Du kan uppdatera de skrivbara egenskaper som definierats i ett gränssnitt på fliken Egenskaper (skrivbar):

  1. Gå till fliken Egenskaper (skrivbar).
  2. Klicka på den egenskap som du vill uppdatera.
  3. Ange det nya värdet för egenskapen .
  4. Förhandsgranska nyttolasten som ska skickas till enheten.
  5. Skicka ändringen.

När du har skickat en ändring kan du spåra uppdateringsstatusen: synching, success, or error. När synkroniseringen är klar visas det nya värdet för egenskapen i kolumnen Rapporterad egenskap. Om du navigerar till andra sidor innan synkroniseringen är klar meddelar verktyget dig fortfarande när uppdateringen är klar. Du kan också använda verktygets meddelandecenter för att se meddelandehistoriken.

Kommandon

Om du vill skicka ett kommando till en enhet går du till fliken Kommandon:

  1. I listan över kommandon expanderar du det kommando som du vill utlösa.
  2. Ange eventuella obligatoriska värden för kommandot.
  3. Förhandsgranska nyttolasten som ska skickas till enheten.
  4. Skicka kommandot.

Telemetri

Om du vill visa telemetri för det valda gränssnittet går du till fliken Telemetri.

Kända problem

En lista över de IoT-funktioner som stöds av den senaste versionen av verktyget finns i Funktionslista.

Nästa steg

I den här artikeln har du lärt dig hur du installerar och använder Azure IoT Explorer för att interagera med dina IoT-Plug and Play enheter. Ett föreslaget nästa steg är att lära dig hur du hanterar IoT Plug and Play digital twins.