Installare e usare Azure Internet ExplorerInstall and use Azure IoT explorer

Azure Internet Explorer è uno strumento grafico per l'interazione con i dispositivi e connessi all'hub Internet delle cose.The Azure IoT explorer is a graphical tool for interacting with and devices connected to your IoT hub. Questo articolo è incentrato sull'uso dello strumento per testare i dispositivi Plug and Play.This article focuses on using the tool to test your IoT Plug and Play devices. Dopo aver installato lo strumento nel computer locale, è possibile usarlo per connettersi a un hub.After installing the tool on your local machine, you can use it to connect to a hub. È possibile usare lo strumento per visualizzare i dati di telemetria inviati dai dispositivi, usare le proprietà del dispositivo e richiamare i comandi.You can use the tool to view the telemetry the devices are sending, work with device properties, and invoke commands.

Questo articolo illustra come:This article shows you how to:

  • Installare e configurare lo strumento Azure Internet Explorer.Install and configure the Azure IoT explorer tool.
  • Usare lo strumento per interagire e testare i dispositivi Plug and Play.Use the tool to interact with and test your IoT Plug and Play devices.

Per informazioni più generali sull'uso dello strumento, vedere il file Leggimidi GitHub.For more general information about using the tool, see the GitHub readme.

Per usare lo strumento Azure Internet Explorer, è necessario:To use the Azure IoT explorer tool, you need:

  • Un hub IoT di Azure.An Azure IoT hub. Sono disponibili diversi modi per aggiungere un hub Internet alla sottoscrizione di Azure, ad esempio la creazione di un hub Internet delle cose usando l'interfaccia della riga di comando di Azure.There are many ways to add an IoT hub to your Azure subscription, such as Creating an IoT hub by using the Azure CLI. Per eseguire lo strumento Azure Internet Explorer è necessaria la stringa di connessione dell'hub Internet.You need the IoT hub connection string to run the Azure IoT explorer tool. Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.If you don't have an Azure subscription, create a free account before you begin.
  • Un dispositivo registrato nell'hub IoT.A device registered in your IoT hub. È possibile usare Esplora risorse per creare e gestire le registrazioni dei dispositivi nell'hub Internet delle cose.You can use IoT Explorer to create and manage device registrations in your IoT Hub.

Installare Azure Internet Explorer ExplorerInstall Azure IoT explorer

Passare ad Azure Internet Explorer releases ed espandere l'elenco degli asset per la versione più recente.Go to Azure IoT explorer releases and expand the list of assets for the most recent release. Scaricare e installare la versione più recente dell'applicazione.Download and install the most recent version of the application.

Importante

Eseguire l'aggiornamento alla versione 0.13. x per risolvere i modelli da qualsiasi repository basato su https://github.com/Azure/iot-plugandplay-modelsUpdate to version 0.13.x to resolve models from any repository based on https://github.com/Azure/iot-plugandplay-models

Usare Esplora risorse di AzureUse Azure IoT explorer

Per un dispositivo, è possibile connettere il proprio dispositivo o usare uno dei dispositivi simulati di esempio.For a device, you can either connect your own device, or use one of the sample simulated devices. Per alcuni dispositivi simulati di esempio scritti in linguaggi diversi, vedere la Guida introduttiva all' applicazione per la connessione di un dispositivo Plug and Play dispositivo a un hub .For some example simulated devices written in different languages, see the Connect a sample IoT Plug and Play device application to IoT Hub quickstart.

Connettersi all'hubConnect to your hub

La prima volta che si esegue Azure Internet Explorer, viene richiesta la stringa di connessione dell'hub.The first time you run Azure IoT explorer, you're prompted for your IoT hub's connection string. Dopo aver aggiunto la stringa di connessione, selezionare Connetti.After you add the connection string, select Connect. È possibile usare le impostazioni dello strumento per passare a un altro hub delle cose aggiornando la stringa di connessione.You can use the tool's settings to switch to another IoT hub by updating the connection string.

La definizione del modello per un dispositivo Plug and Play viene archiviata sia nel repository pubblico, nel dispositivo connesso o in una cartella locale.The model definition for an IoT Plug and Play device is stored in either the public repository, the connected device, or a local folder. Per impostazione predefinita, lo strumento Cerca la definizione del modello nel repository pubblico e nel dispositivo connesso.By default, the tool looks for your model definition in the public repository and your connected device. È possibile aggiungere e rimuovere origini oppure configurare la priorità delle origini nelle Impostazioni:You can add and remove sources, or configure the priority of the sources in Settings:

Per aggiungere un'origine:To add a source:

  1. Vai a Home/Plug and Play le impostazioniGo to Home/IoT Plug and Play Settings
  2. Selezionare Aggiungi e scegliere l'origine, da un repository o da una cartella locale.Select Add and choose your source, from a repository or local folder.

Per rimuovere un'origine:To remove a source:

  1. Vai a Home/Plug and Play le impostazioniGo to Home/IoT Plug and Play Settings
  2. Individuare l'origine che si desidera rimuovere.Find the source you want to remove.
  3. Selezionare X per rimuoverlo.Select X to remove it.

Modificare le priorità di origine:Change the source priorities:

È possibile trascinare e rilasciare una delle origini della definizione del modello in un rango diverso nell'elenco.You can drag and drop one of the model definition sources to a different ranking in the list.

Visualizzare i dispositiviView devices

Una volta che lo strumento si connette all'hub Internet, Visualizza la pagina di elenco dei dispositivi in cui sono elencate le identità del dispositivo registrate con l'hub Internet.After the tool connects to your IoT hub, it displays the Devices list page that lists the device identities registered with your IoT hub. Per visualizzare altre informazioni, è possibile selezionare qualsiasi voce nell'elenco.You can select any entry in the list to see more information.

Nella pagina dell'elenco dei dispositivi è possibile:On the Devices list page you can:

  • Selezionare nuovo per registrare un nuovo dispositivo con l'hub.Select New to register a new device with your hub. Immettere quindi un ID dispositivo.Then enter a device ID. Usare le impostazioni predefinite per generare automaticamente le chiavi di autenticazione e abilitare la connessione all'hub.Use the default settings to automatically generate authentication keys and enable the connection to your hub.
  • Selezionare un dispositivo e quindi fare clic su Elimina per eliminare un'identità del dispositivo.Select a device and then select Delete to delete a device identity. Esaminare i dettagli del dispositivo prima di completare questa azione per assicurarsi di eliminare l'identità del dispositivo corretta.Review the device details before you complete this action to be sure you're deleting the right device identity.

Interagire con un dispositivoInteract with a device

Nella pagina elenco dispositivi selezionare un valore nella colonna ID dispositivo per visualizzare la pagina dei dettagli del dispositivo registrato.On the Devices list page, select a value in the Device ID column to view the detail page for the registered device. Per ogni dispositivo sono presenti due sezioni: Device e Digital gemelle.For each device there are two sections: Device and Digital Twin.

DispositivoDevice

Questa sezione include le schede identità dispositivo, dispositivo gemello, telemetria, metodo diretto, messaggio da cloud a dispositivo, identità modulo .This section includes the Device Identity, Device Twin, Telemetry, Direct method, Cloud-to-device message, Module Identity tabs.

  • È possibile visualizzare e aggiornare le informazioni sull' identità del dispositivo nella scheda identità dispositivo .You can view and update the device identity information on the Device identity tab.
  • È possibile accedere alle informazioni sul dispositivo gemello nella scheda del dispositivo gemello .You can access the device twin information on the Device Twin tab.
  • Se un dispositivo è connesso e invia attivamente dati, è possibile visualizzare i dati di telemetria nella scheda telemetria .If a device is connected and actively sending data, you can view the telemetry on the Telemetry tab.
  • È possibile chiamare un metodo diretto sul dispositivo nella scheda metodo diretto .You can call a direct method on the device on the Direct method tab.
  • È possibile inviare un messaggio da cloud a dispositivo nella scheda messaggi da cloud a dispositivo .You can send a cloud-to-device message on the Cloud-to-device messages tab.
  • È possibile accedere alle informazioni del modulo gemello .You can access the module twin information.

Componenti Plug and PlayIoT Plug and Play components

Se il dispositivo è connesso all'hub usando un ID modello, lo strumento Mostra la scheda componenti plug and Play , in cui è possibile visualizzare l' ID modello.If the device is connected to the hub using a Model ID, the tool shows the IoT Plug and Play components tab where you can see the Model ID.

Se l' ID del modello è disponibile in una delle origini configurate, ovvero il repository pubblico o la cartella locale, viene visualizzato l'elenco dei componenti.If the Model ID is available in one of the configured sources - Public Repo or Local Folder, the list of components is displayed. Selezionando un componente vengono visualizzate le proprietà, i comandi e i dati di telemetria disponibili.Selecting a component shows the properties, commands, and telemetry available.

Nella pagina componente è possibile visualizzare le proprietà di sola lettura, aggiornare le proprietà scrivibili, richiamare i comandi e visualizzare i messaggi di telemetria prodotti da questo componente.On the Component page, you can view the read-only properties, update writable properties, invoke commands, and see the telemetry messages produced by this component.

Visualizzare i componenti in Azure IoT Explorer

ProprietàProperties

Visualizzare le proprietà in Azure Internet Explorer

È possibile visualizzare le proprietà di sola lettura definite in un'interfaccia nella scheda Proprietà (sola lettura) . È possibile aggiornare le proprietà scrivibili definite in un'interfaccia nella scheda Proprietà (scrivibile) :You can view the read-only properties defined in an interface on the Properties (read-only) tab. You can update the writable properties defined in an interface on the Properties (writable) tab:

  1. Passare alla scheda Proprietà (scrivibile) .Go to the Properties (writable) tab.
  2. Fare clic sulla proprietà che si desidera aggiornare.Click the property you'd like to update.
  3. Immettere il nuovo valore per la proprietà.Enter the new value for the property.
  4. Visualizzare in anteprima il payload da inviare al dispositivo.Preview the payload to be sent to the device.
  5. Inviare la modifica.Submit the change.

Dopo aver inviato una modifica, è possibile tenere traccia dello stato di aggiornamento: sincronizzazione, esito positivo o errore.After you submit a change, you can track the update status: synching, success, or error. Al termine della sincronizzazione, viene visualizzato il nuovo valore della proprietà nella colonna delle proprietà restituita .When the synching is complete, you see the new value of your property in the Reported Property column. Se si passa ad altre pagine prima del completamento della sincronizzazione, lo strumento continua a notificare il completamento dell'aggiornamento.If you navigate to other pages before the synching completes, the tool still notifies you when the update is complete. È anche possibile usare il centro notifiche dello strumento per visualizzare la cronologia delle notifiche.You can also use the tool's notification center to see the notification history.

Comandi:Commands

Per inviare un comando a un dispositivo, passare alla scheda comandi :To send a command to a device, go to the Commands tab:

  1. Nell'elenco dei comandi espandere il comando che si desidera attivare.In the list of commands, expand the command you want to trigger.
  2. Immettere i valori necessari per il comando.Enter any required values for the command.
  3. Visualizzare in anteprima il payload da inviare al dispositivo.Preview the payload to be sent to the device.
  4. Inviare il comando.Submit the command.

TelemetriaTelemetry

Per visualizzare i dati di telemetria per l'interfaccia selezionata, passare alla relativa scheda di telemetria .To view the telemetry for the selected interface, go to its Telemetry tab.

Problemi notiKnown Issues

Per un elenco delle funzionalità di Internet delle cose supportate dalla versione più recente dello strumento, vedere elenco delle funzionalità.For a list of the IoT features supported by the latest version of the tool, see Feature list.

Passaggi successiviNext steps

In questo articolo sulle procedure si è appreso come installare e usare Azure Internet Explorer Explorer per interagire con i dispositivi Plug and Play.In this how-to article, you learned how to install and use Azure IoT explorer to interact with your IoT Plug and Play devices. Un passaggio successivo suggerito consiste nell'apprendere come installare e usare gli strumenti di creazione di DTDL.A suggested next step is to learn how to Install and use the DTDL authoring tools.