Install and use Azure IoT explorer

The Azure IoT explorer is a graphical tool for interacting with and testing your IoT Plug and Play Preview devices. After installing the tool on your local machine, you can use it to connect to a hub. You can use the tool to view the telemetry the devices are sending, work with device properties, and invoke commands.

This article shows you how to:

  • Install and configure the Azure IoT explorer tool.
  • Use the tool to interact with and test your devices.

Prerequisites

To use the Azure IoT explorer tool, you need:

  • An Azure IoT hub. There are many ways to add an IoT hub to your Azure subscription, such as Creating an IoT hub by using the Azure CLI. You need the IoT hub connection string to run the Azure IoT explorer tool. If you don't have an Azure subscription, create a free account before you begin.

  • A device registered in your IoT hub. You can use the following Azure CLI command to register a device. Be sure to replace the {YourIoTHubName} and {YourDeviceID} placeholders with your values:

    az iot hub device-identity create --hub-name {YourIoTHubName} --device-id {YourDeviceID}
    

Install Azure IoT explorer

Go to Azure IoT explorer releases and expand the list of assets for the most recent release. Download and install the most recent version of the application.

Important

From version 0.11.0 IoT Explorer only supports the IoT Plug and Play May 2020 preview-release. To use the features available in the previous preview-release from Aug 2019 you must install a 0.10.x version.

Use Azure IoT explorer

For a device, you can either connect your own device, or use one of our sample simulated devices. Follow these instructions to run the simulated device sample.

Connect to your hub

The first time you run Azure IoT explorer, you're prompted for your IoT hub's connection string. After you add the connection string, select Connect. You can use the tool's settings to switch to another IoT hub by updating the connection string.

The model definition for an IoT Plug and Play device is stored in either the public repository, the connected device, or a local folder. By default, the tool looks for your model definition in the public repository and your connected device. You can add and remove sources, or configure the priority of the sources in Settings:

To add a source:

  1. Go to Home/IoT Plug and Play Settings
  2. Select Add and choose your source, from a repository or local folder.

To remove a source:

  1. Go to Home/IoT Plug and Play Settings
  2. Find the source you want to remove.
  3. Select X to remove it.

Change the source priorities:

You can drag and drop one of the model definition sources to a different ranking in the list.

View devices

After the tool connects to your IoT hub, it displays the Devices list page that lists the device identities registered with your IoT hub. You can select any entry in the list to see more information.

On the Devices list page you can:

  • Select New to register a new device with your hub. Then enter a device ID. Use the default settings to automatically generate authentication keys and enable the connection to your hub.
  • Select a device and then select Delete to delete a device identity. Review the device details before you complete this action to be sure you're deleting the right device identity.

Interact with a device

On the Devices list page, select a value in the Device ID column to view the detail page for the registered device. For each device there are two sections: Device and Digital Twin.

Device

This section includes the Device Identity, Device Twin, Telemetry, Direct method, Cloud-to-device message, Module Identity tabs.

  • You can view and update the device identity information on the Device identity tab.
  • You can access the device twin information on the Device Twin tab.
  • If a device is connected and actively sending data, you can view the telemetry on the Telemetry tab.
  • You can call a direct method on the device on the Direct method tab.
  • You can send a cloud-to-device message on the Cloud-to-device messages tab.
  • You can access the module twin information.

IoT Plug and Play components

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.

If the Model ID is available in one of the configured sources - Public Repo or Local Folder, the list of components is displayed. Selecting a component shows the properties, commands, and telemetry available.

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.

View components in Azure IoT explorer

Properties

View properties in Azure IoT explorer

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. Go to the Properties (writable) tab.
  2. Click the property you'd like to update.
  3. Enter the new value for the property.
  4. Preview the payload to be sent to the device.
  5. Submit the change.

After you submit a change, you can track the update status: synching, success, or error. When the synching is complete, you see the new value of your property in the Reported Property column. If you navigate to other pages before the synching completes, the tool still notifies you when the update is complete. You can also use the tool's notification center to see the notification history.

Commands

To send a command to a device, go to the Commands tab:

  1. In the list of commands, expand the command you want to trigger.
  2. Enter any required values for the command.
  3. Preview the payload to be sent to the device.
  4. Submit the command.

Telemetry

To view the telemetry for the selected interface, go to its Telemetry tab.

Next steps

In this how-to article, you learned how to install and use Azure IoT explorer to interact with your IoT Plug and Play devices. A suggested next step is to learn how to use the Azure CLI IoT Plug and Play commands.